For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
This page is for API, version 2026-01-01 (Stable) (default).
For other versions, use one of these documentation indexes:
- 2026-01-01 (Stable) (default): https://developer.deel.com/api/stable/llms.txt
Use this endpoint to retrieve a specific worker’s time-off history or upcoming requests — e.g. to build a worker-facing view, check availability before scheduling, or reconcile attendance during payroll. Unlike GET /rest/time_offs, which lists requests org-wide, this scopes to a single hris_profile_id. Combine the status, policy, and date-range filters to narrow results, and page through history with page_size and next.
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'
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.
