Get Policies for Organization

GET

/time-offs/policy

GET

/rest/time-offs/policy

$ curl -G https://api.letsdeel.com/rest/time-offs/policy \
>      -H "Authorization: Bearer <token>" \
>      -d policy_type=Vacation \
>      --data-urlencode "policy_name=Standard PTO" \
>      -d country=US \
>      -d state_or_region=CA \
>      -d worker_types_assigned=eor \
>      -d has_workers_assigned=true \
>      -d page_size=20 \
>      -d next=eyJpZCI6IjEyMyJ9

1 {
2   "data": [
3     {
4       "id": "f7b3b3b3-3b3b-3b3b-3b3b-3b3b3b3b3b3b",
5       "name": "Standard PTO Policy",
6       "created_at": "2025-01-01T00:00:00Z",
7       "leave_type": "SHORT_TERM_LEAVE",
8       "updated_at": "2025-01-01T00:00:00Z",
9       "policy_type": {
10         "id": "a1b2c3d4-e5f6-7g8h-9i0j-k1l2m3n4o5p6",
11         "name": "Paid Time Off"
12       },
13       "payment_type": "PAID",
14       "is_event_based": false,
15       "time_off_types": [
16         {
17           "id": "a1b2c3d4-e5f6-7g8h-9i0j-k1l2m3n4o5p6",
18           "name": "Paid Time Off",
19           "description": "This policy provides paid time off for employees."
20         }
21       ],
22       "tracking_cadence": "FIXED_DAY",
23       "policy_allowances": [
24         {
25           "id": "a1b2c3d4-e5f6-7g8h-9i0j-k1l2m3n4o5p6",
26           "type": "BASE_ALLOWANCE",
27           "accrual_type": "TIMEFRAME",
28           "rollover_type": "CARRY_OVER",
29           "balance_tracking_type": "INFLEXIBLE",
30           "entitlement_start_type": "IMMEDIATELY",
31           "is_unlimited_allowance": false,
32           "is_bank_holidays_enabled": true,
33           "should_zero_out_negative_balances_on_rollover": false,
34           "accrual_unit": "BUSINESS_DAY",
35           "entitlement_unit": "BUSINESS_DAY",
36           "accrual_unit_amount": 1,
37           "entitlement_start_date": "2025-01-01",
38           "entitlement_start_unit": "BUSINESS_DAY",
39           "entitlement_unit_amount": 10,
40           "accrual_application_type": "BEGIN_OF_CYCLE",
41           "rollover_expiration_unit": "MONTH",
42           "rollover_limit_unit_amount": 5,
43           "entitlement_expiration_unit": "BUSINESS_DAY",
44           "entitlement_start_unit_amount": 3,
45           "rollover_expiration_unit_amount": 3,
46           "entitlement_expiration_unit_amount": 3,
47           "part_time_prorated_entitlement_unit_amount": 2,
48           "balance_tracking_flexible_custom_request_amount": 5
49         }
50       ],
51       "request_start_type": "IMMEDIATELY",
52       "overlap_request_type": "NOT_ALLOWED",
53       "time_off_request_type": "FULL_DAY",
54       "is_attachment_required": true,
55       "assigned_profiles_count": 42,
56       "is_description_required": true,
57       "policy_allowance_proration": {
58         "is_prorated_on_hire": true,
59         "is_prorated_on_termination": true,
60         "part_time_worker_treatment_type": "SAME_AS_FTE",
61         "part_time_worker_treatment_specific_amount": 50
62       },
63       "retrospective_request_type": "NOT_ALLOWED",
64       "should_allow_editing_past_time_offs": false,
65       "description": "This policy provides standard paid time off for employees",
66       "tracking_unit": "YEAR",
67       "notice_period_unit": "BUSINESS_DAY",
68       "request_start_unit": "MONTH",
69       "tracking_start_date": "2025-01-01",
70       "tracking_unit_amount": 1,
71       "notice_period_unit_amount": 5,
72       "request_start_unit_amount": 3,
73       "auto_approval_inactivity_time_unit": "BUSINESS_DAY",
74       "auto_approval_inactivity_time_unit_amount": 5
75     }
76   ],
77   "next": "string",
78   "has_next_page": true
79 }

Look up an organization’s time-off policies, most commonly to resolve a policy_id for use with Get Profiles Assigned to Policy, or to audit policy configuration (allowances, tracking rules) before assigning workers or reviewing compliance. Filter by policy_type to narrow results to the leave categories relevant to your integration; each result’s assigned profile count lets you spot unused or over-assigned policies without an extra call.

Token scopes: time-off:read

Look up an organization's time-off policies, most commonly to resolve a policy_id for use with Get Profiles Assigned to Policy, or to audit policy configuration (allowances, tracking rules) before assigning workers or reviewing compliance. Filter by policy_type to narrow results to the leave categories relevant to your integration; each result's assigned profile count lets you spot unused or over-assigned policies without an extra call. **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.deel.training/rest/v2/contracts' \
>   -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

## 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 curl -X GET 'https://api.deel.training/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)

AuthorizationBearer

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

Query parameters

policy_typelist of enumsOptional

Filter by policy type names

policy_namestringOptional

Filter by policy name (case-insensitive search)

countrylist of stringsOptional

Filter by country codes

state_or_regionlist of stringsOptional

Filter by state/region codes

worker_types_assignedlist of stringsOptional

Filter by worker types

has_workers_assignedbooleanOptional

Filter by assignment status

page_sizeintegerOptional1-50

Items per page (max 50)

nextstringOptional

Pagination token from the previous response (next)

Response

Paginated list of policies.

datalist of objects

nextstring or nullOptional

Opaque cursor to fetch the next page of results. Null when there are no more results

has_next_pagebooleanOptional

Indicates if there are more results available beyond the current page

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -X GET 'https://api.deel.training/rest/v2/contracts' \
>	-H 'Authorization: Bearer YOUR-TOKEN-HERE'