Skip to main content
GET
List Workforce Employees With Contracts
← Own Workforce API Return every employee of the organization tree with their contracts nested inside, and each contract’s remuneration periods nested inside that. One call instead of walking employee → contracts → remunerations.
This endpoint does not paginate and takes no filters. It walks the header organization and its descendants and returns every employee, every contract and every remuneration period in a single response. For an organization with thousands of employees that payload is large and the request is slow. Use List Workforce Employees when you can page, and this one only when you genuinely need the whole nested tree.
Remuneration amounts are not included here. The nested remuneration objects carry only start_date and end_date, so this endpoint tells you when someone was paid on a given band, not how much. For amounts and currency, call List Workforce Remunerations per contract, or read the aggregates from Query datasets.

Request

Headers

string
required
Your API key for authenticationExample: sk_live_1234567890abcdef
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Response

array[object]
Note that the employee objects here carry no id: they are keyed by external_employee_id within their organization. To address an employee on the other endpoints, resolve the UUID through List Workforce Employees.

Example

Successful Response

Common Errors

401 Unauthorized

Cause: the key is invalid, or it does not belong to the organization in x-organization-id — the two are looked up as a pair. A request carrying no credentials at all answers AUTH_REQUIRED instead.

403 Forbidden

Cause: the key’s owner is not an enabled member of the organization in x-organization-id.

List employees

The paginated, filterable alternative

List remunerations

Amounts and currency, per contract