Skip to main content
GET
List Workforce Absences by Employee
← Own Workforce API Return the absence and accident records of a single employee. The employee id goes in the path, which is what distinguishes this from the organization-wide List Workforce Absences.
These records are health data: sick-leave dates and hours, and the context of workplace accidents, each tied to an identifiable employee. That is special-category personal data under the GDPR. Do not log responses verbatim or cache them in shared stores, and restrict the API keys that can reach this endpoint.

Request

Headers

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

Path Parameters

string
required
Employee UUID, from List Workforce EmployeesExample: 550e8400-e29b-41d4-a716-446655440000

Response

A bare JSON array with the same fields as List Workforce Absences, including the accident/absence split described there. An employee with no records returns an empty array, not a 404.

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.

404 Not Found

Cause: no employee with that id inside your perimeter. An employee owned by another organization answers 404, the same as one that does not exist.

Get employee

The person these records belong to

Trainings of an employee

The same view for trainings