Retrieve a list of ATS jobs

GET

/ats/jobs

GET

/rest/v2/ats/jobs

$ curl -G https://api.letsdeel.com/rest/v2/ats/jobs \
>      -H "Authorization: Bearer <token>" \
>      -d cursor=cursorValue \
>      -d limit=50 \
>      -d search=engineer \
>      -d interview_plan_id=b3b7c8e2-4e2a-4c3b-9e2d-1a2b3c4d5e6f \
>      -d location_ids=d1e2f3a4-b5c6-7d8e-9f01-23456789abcd \
>      -d team_ids=a1b2c3d4-e5f6-7a8b-9c0d-1234567890ab \
>      -d employment_type_ids=e1f2a3b4-c5d6-7e8f-9a01-23456789bcde \
>      -d department_ids=f1e2d3c4-b5a6-7c8d-9e0f-123456789abc \
>      --data-urlencode updated_after=2025-06-18T00:00:00.000Z \
>      -d status=OPEN \
>      -d status=CLOSED

1 {
2   "data": [
3     {
4       "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
5       "title": "Software Engineer",
6       "status": "OPEN",
7       "job_teams": [
8         {
9           "id": "f1e2d3c4-b5a6-7890-1234-567890abcdef",
10           "team": {
11             "id": "c1d2e3f4-a5b6-7890-1234-567890abcdef",
12             "name": "Engineering Team"
13           }
14         }
15       ],
16       "created_at": "2023-10-01T12:00:00Z",
17       "updated_at": "2023-10-02T12:00:00Z",
18       "job_locations": [
19         {
20           "id": "b1c2d3e4-f5a6-7890-1234-567890abcdef",
21           "location": {
22             "id": "d1e2f3a4-b5c6-7890-1234-567890abcdef",
23             "name": "New York"
24           }
25         }
26       ],
27       "hiring_members": [
28         {
29           "id": "91a8b7c6-d5e4-4321-abcd-ef0123456789",
30           "hris_organization_user_id": "89abcdef-0123-4567-89ab-cdef01234567"
31         }
32       ],
33       "is_confidential": false,
34       "job_departments": [
35         {
36           "id": "67890abc-def1-2345-6789-abcdef012345",
37           "department": {
38             "id": "567890ab-cdef-1234-5678-90abcdef012345",
39             "name": "Sales"
40           }
41         }
42       ],
43       "approval_rule_id": "7890abcd-ef01-2345-6789-abcdef012345",
44       "applications_count": 10,
45       "approval_request_id": "4567890a-bcde-f012-3456-7890abcdef01",
46       "current_compensation": {
47         "id": "comp-1234-5678-90ab-cdef",
48         "job_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
49         "max_amount": 120000,
50         "min_amount": 80000,
51         "period_slug": "ANNUALLY",
52         "currency_iso_code": "USD"
53       },
54       "job_employment_types": [
55         {
56           "id": "34567890-abcd-ef01-2345-67890abcdef0",
57           "employment_type": {
58             "id": "23456789-0abc-def1-2345-67890abcdef01",
59             "name": "Full-time"
60           }
61         }
62       ],
63       "richtext_description": "<div>Job description in rich text format</div>",
64       "interview_plan_stages": [
65         {
66           "id": "12345678-90ab-cdef-0123-456789abcdef",
67           "name": "Phone Screen",
68           "position_number": 1,
69           "default_type_slug": "phone_screen",
70           "interview_plan_id": "98765432-10ab-cdef-0123-456789abcdef",
71           "category_type_slug": "ACTIVE"
72         }
73       ],
74       "approval_request_stringified": "Approval request details in string format",
75       "created_by_hris_organization_user_id": "01234567-89ab-cdef-0123-456789abcdef",
76       "hiring_member_job_permissions_by_type_slug": {
77         "hiring_team": "read",
78         "job_posting": "write",
79         "compensation": "read",
80         "interview_plan": "write",
81         "application_form_submission": "read",
82         "application_form_submission_sensitive_fields": "none"
83       }
84     }
85   ],
86   "has_more": true,
87   "next_cursor": "abcdef01-2345-6789-0abc-def012345678",
88   "total_count": 100
89 }

Returns a paginated list of jobs in the ATS, filterable by text search, interview plan, locations, teams, employment types, departments, status values, and an ISO 8601 updated_after timestamp. Token scopes: ats: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

## 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.letsdeel.com/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

cursorstringOptional

The cursor for pagination

limitintegerOptional1-100Defaults to 20

Maximum number of records returned in one response

searchstringOptional

Text to search for in job records (optional)

interview_plan_idstringOptionalformat: "uuid"

Interview plan UUID (optional)

location_idslist of stringsOptional

Array of location UUIDs (optional)

team_idslist of stringsOptional

Array of team UUIDs (optional)

employment_type_idslist of stringsOptional

Array of employment type UUIDs (optional)

department_idslist of stringsOptional

Array of department UUIDs (optional)

updated_afterstringOptionalformat: "date-time"

Filter jobs updated after this timestamp (ISO 8601 format)

statuslist of enumsOptional

Array of job status values (optional)

Response

Successful operation.

datalist of objects

has_moreboolean

Indicates if there are more items to fetch.

next_cursorstring or null

Cursor for the next page of results

total_countinteger>=0

Total number of jobs

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

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