Worker turnover totals

The worker turnover totals endpoint returns aggregate turnover metrics for a single date range. Use this to get a snapshot of headcount, turnover counts, and turnover rates for your organisation.

For the full request/response specification, see the API reference.

Metric definitions

Headcount

Metric	Definition
beginning_headcount	Number of active workers at the start of the reporting period.
ending_headcount	Number of active workers at the end of the reporting period.
new_hires	Workers who started their first shift during the reporting period.
rehires	Workers who returned and worked a shift after a previous turnover event at the same venue.

Turnover counts

Metric	Definition
total_turnover	Total number of turnover events in the period (voluntary + involuntary).
voluntary_turnover	Worker-initiated departures (e.g. worker cancellation, resignation, found another job).
involuntary_turnover	Employer-initiated departures (e.g. employer cancellation, employer blacklist, platform ban).
headcount_reduction	Workers who left because the employer's staffing needs ended. Headcount reduction is tracked separately and is not included in the total turnover count.

Turnover rate

Metric	Definition
turnover_rate	The rate of turnover for the period, expressed as a percentage.

Turnover reason types

Each turnover event is classified into one of three high-level categories:

Category	Description
Voluntary Turnover	The worker chose to leave. Includes worker cancellations and other worker-initiated departures.
Involuntary Turnover	The employer or platform removed the worker. Includes employer cancellations, employer blacklists, and platform bans.
Headcount Reduction	The employer's staffing needs ended naturally. These events are excluded from turnover totals and rates because they do not represent worker churn.

Turnover sources

The underlying turnover events are categorised by source:

Source	Description
worker_cancellation	The worker cancelled their assignment.
employer_cancellation	The employer cancelled the worker's assignment.
employer_blacklist	The employer blocked the worker from future shifts.
platform_ban	The worker was banned from the Indeed Flex platform.

Worker types

Turnover metrics cover two worker types:

Worker type	Description
Flexer	Workers sourced through the Indeed Flex platform.
Agency	Workers provided by external staffing agencies.

Request parameters

Parameter	Required	Description
employer_id	Yes	me (recommended) or your numeric employer ID (path parameter). me resolves to the employer associated with your OAuth credentials.
from_date	Yes	Start date in ISO 8601 format (YYYY-MM-DD).
to_date	Yes	End date in ISO 8601 format (YYYY-MM-DD).

Example request

curl -X POST "https://client-api.indeedflex.com/v1/reporting/me/reports/worker_turnover/totals?from_date=2026-01-01&to_date=2026-03-31" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '[]'

 

Was this page helpful?