Skip to navigation

List Time Off Policies

Returns the time off policies configured by the organization — vacations, leaves and permissions — paginated and filterable. Each item describes how the policy behaves: its category, whether it is paid or unlimited, the unit it is measured in and whether requests need approval. It does not include requests nor employee data.

Authentication

Api-Keystring

API key of the organization. Always sent together with the Secret-Access header.

Path parameters

organization_slugstringRequired

Headers

Secret-AccessstringRequired

Query parameters

policy_idstringOptional
Filter by policy id. Returns only that policy.
searchstringOptional

Free-text search across the policy names.

namestringOptional
Filter by exact policy name.
policy_type_idslist of stringsOptional
Filter by policy category id. Repeat the parameter to pass several ids.
is_paidbooleanOptional
Filter by whether the absence is paid.
order_byenumOptional
Sort order for the results.
Allowed values:
limitintegerOptional1-50

Results per page (1-50).

offsetintegerOptional>=0

Number of results to skip (zero-based).

Response

Time off policies page
resultslist of objects
Current page of policies.
totalintegerOptional
Total number of matching policies.

Errors

400
Bad Request Error
403
Forbidden Error
422
Unprocessable Entity Error