List job openings

GET

/ats/openings

GET

/rest/v2/ats/openings

$ curl -G https://api.letsdeel.com/rest/v2/ats/openings \
>      -H "Authorization: Bearer <token>" \
>      -d cursor=eyJpZCI6IjEyMzQifQ \
>      -d limit=50 \
>      -d status=OPEN \
>      -d team_ids=f47ac10b-58cc-4372-a567-0e02b2c3d479 \
>      -d location_ids=f47ac10b-58cc-4372-a567-0e02b2c3d479 \
>      -d job_ids=f47ac10b-58cc-4372-a567-0e02b2c3d479 \
>      -d tag_ids=f47ac10b-58cc-4372-a567-0e02b2c3d479 \
>      -d tag_ids_operator=ANY

1 {
2   "data": [
3     {
4       "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
5       "title": "Senior Software Engineer",
6       "status": "OPEN",
7       "created_at": "2026-01-15T08:00:00Z",
8       "updated_at": "2026-01-20T14:30:00Z",
9       "opening_prefix": "ENG",
10       "opening_type_slug": "NEW_HIRE",
11       "opening_numeric_id": 42,
12       "team": {
13         "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
14         "name": "Backend Engineering"
15       },
16       "job_ids": [
17         "f47ac10b-58cc-4372-a567-0e02b2c3d479"
18       ],
19       "team_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
20       "location": {
21         "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
22         "name": "New York",
23         "country": "US"
24       },
25       "location_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
26       "employment_type": {
27         "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
28         "name": "Full-time"
29       },
30       "is_confidential": false,
31       "target_hire_date": "2026-09-01T00:00:00Z",
32       "target_start_date": "2026-10-01T00:00:00Z",
33       "employment_type_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
34       "compensation_period": "yearly",
35       "max_compensation_amount": "120000.0000",
36       "min_compensation_amount": "80000.0000",
37       "filled_by_application_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
38       "compensation_currency_iso_code": "USD",
39       "created_by_hris_organization_user_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
40       "updated_by_hris_organization_user_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
41     }
42   ],
43   "has_more": false,
44   "next_cursor": "eyJpZCI6IjEyMzQifQ==",
45   "total_count": 42
46 }

Returns all job openings (requisitions/headcount requests) for the authenticated organization. Supports filtering by status, team, location, and linked job. Results are cursor-paginated. Openings track headcount requests through a lifecycle from DRAFT to FILLED or CLOSED. 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

Pagination cursor returned by a previous response.

limitintegerOptional1-100

Maximum number of openings to return per page.

statuslist of enumsOptional

Filter openings by one or more statuses.

team_idslist of stringsOptional

Filter openings by team IDs.

location_idslist of stringsOptional

Filter openings by location IDs.

job_idslist of stringsOptional

Filter openings by linked job IDs.

tag_idslist of stringsOptional

Filter openings by tag IDs.

tag_ids_operatorenumOptional

Operator for tag_ids filter. ‘ANY’ returns openings with at least one matching tag; ‘ALL’ returns openings with all specified tags. Defaults to ‘ANY’.

Allowed values:

Response

Paginated list of job openings.

datalist of objects

Page of openings.

has_moreboolean

Whether more pages are available beyond the current page.

next_cursorstring or null

Cursor to fetch the next page; null when there are no more pages.

total_countinteger

Total number of openings matching the filters.

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'