Skip to navigation
EndpointsTime Off

List time-off requests for Organization

Returns time-off requests across the entire authenticated organization; to list a single worker’s requests, use GET /rest/time_offs/profile/{hris_profile_id} instead. Intended for bulk synchronization or auditing into an external HRIS, payroll, or reporting system. Only requests belonging to workers with an active primary employment are returned, and pending requests are included alongside approved and closed ones unless you filter by status.

Token scopes: time-off:read

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
  -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

OR
AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Query parameters

statuslist of enumsOptional
Time off status
time_off_idslist of stringsOptional
Time off ids
start_datestringOptionalformat: "date-time"
Start date of time off
end_datestringOptionalformat: "date-time"
End date of time off
approval_start_datestringOptionalformat: "date-time"
Approval start date
approval_end_datestringOptionalformat: "date-time"
Approval end date
updated_start_datestringOptionalformat: "date-time"
Updated start date
updated_end_datestringOptionalformat: "date-time"
Updated end date
page_sizeintegerOptional5-200
Page size
policy_typeslist of stringsOptional
Policy types
policy_type_nameslist of enumsOptional

Filter by policy type names. When omitted, Work Location time-offs are excluded by default. Pass policy_type_names=Work+Location to retrieve only Work Location entries.

nextstringOptional
Next page
include_deleted_time_offsbooleanOptionalDefaults to false

When true, includes soft-deleted time-off records in the response. Deleted records will have a deleted_at timestamp and status DELETED.

Response

Successful operation time offs returned
datalist of objects
page_sizeinteger5-200
Page size
has_next_pageboolean
Has next page
nextstringOptional
countintegerOptional
Total count of items

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error