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 }

Retrieves all policies with optional filtering. Returns policy details including allowances and tracking configuration, plus assigned profile count.

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 null

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

has_next_pageboolean

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'