Retrieve ATS job postings

GET

/ats/job-postings

GET

/rest/v2/ats/job-postings

$ curl -G https://api.letsdeel.com/rest/v2/ats/job-postings \
>      -H "Authorization: Bearer <token>" \
>      -d job_board_id=3fa85f64-5717-4562-b3fc-2c963f66afa6 \
>      -d job_id=6ba7b810-9dad-11d1-80b4-00c04fd430c8 \
>      -d cursor=eyJwYWdlIjoyfQ \
>      -d limit=20

1 {
2   "data": [
3     {
4       "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
5       "job": {
6         "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
7         "compensation": {
8           "id": "e7f8a9b0-c1d2-3456-0123-567890123456",
9           "max_amount": 140000,
10           "min_amount": 100000,
11           "currency_iso_code": "USD"
12         },
13         "job_locations": [
14           {
15             "id": "a3b4c5d6-e7f8-9012-6789-123456789012",
16             "location": {
17               "id": "b4c5d6e7-f8a9-0123-7890-234567890123",
18               "name": "London"
19             }
20           }
21         ],
22         "job_employment_types": [
23           {
24             "id": "c5d6e7f8-a9b0-1234-8901-345678901234",
25             "employment_type": {
26               "id": "d6e7f8a9-b0c1-2345-9012-456789012345",
27               "name": "Full-time"
28             }
29           }
30         ],
31         "job_teams": [
32           {
33             "id": "c9d0e1f2-a3b4-5678-2345-789012345678",
34             "team": {
35               "id": "d0e1f2a3-b4c5-6789-3456-890123456789",
36               "name": "Engineering"
37             }
38           }
39         ],
40         "job_departments": [
41           {
42             "id": "e1f2a3b4-c5d6-7890-4567-901234567890",
43             "department": {
44               "id": "f2a3b4c5-d6e7-8901-5678-012345678901",
45               "name": "Product"
46             }
47           }
48         ]
49       },
50       "title": "Senior Engineer",
51       "job_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
52       "publications": [
53         {
54           "id": "f8a9b0c1-d2e3-4567-1234-678901234567",
55           "job_board": {
56             "id": "a9b0c1d2-e3f4-5678-2345-789012345678"
57           },
58           "current_state": {
59             "id": "b0c1d2e3-f4a5-6789-3456-890123456789",
60             "created_at": "2025-03-10T09:00:00.000Z",
61             "created_by": "c1d2e3f4-a5b6-7890-4567-901234567890",
62             "state_slug": "PUBLISHED_BASIC",
63             "error_message": "Error message"
64           }
65         }
66       ],
67       "richtext_description": "<p>Build great products with us.</p>",
68       "is_compensation_visible": "true",
69       "created_at": "2025-01-15T10:30:00.000Z",
70       "updated_at": "2025-02-01T14:00:00.000Z",
71       "application_form": {
72         "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
73         "title": "Default application"
74       }
75     }
76   ],
77   "has_more": "false",
78   "next_cursor": "nextcursorid",
79   "total_count": 3
80 }

Use this endpoint to retrieve job postings by specifying the job board ID or job ID. It provides detailed postings with job details, publication status, and relevant metadata. Token scopes: ats:read

Retrieve ATS job postings

GET

/ats/job-postings

GET

/rest/v2/ats/job-postings

$ curl -G https://api.letsdeel.com/rest/v2/ats/job-postings \
>      -H "Authorization: Bearer <token>" \
>      -d job_board_id=3fa85f64-5717-4562-b3fc-2c963f66afa6 \
>      -d job_id=6ba7b810-9dad-11d1-80b4-00c04fd430c8 \
>      -d cursor=eyJwYWdlIjoyfQ \
>      -d limit=20

1 {
2   "data": [
3     {
4       "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
5       "job": {
6         "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
7         "compensation": {
8           "id": "e7f8a9b0-c1d2-3456-0123-567890123456",
9           "max_amount": 140000,
10           "min_amount": 100000,
11           "currency_iso_code": "USD"
12         },
13         "job_locations": [
14           {
15             "id": "a3b4c5d6-e7f8-9012-6789-123456789012",
16             "location": {
17               "id": "b4c5d6e7-f8a9-0123-7890-234567890123",
18               "name": "London"
19             }
20           }
21         ],
22         "job_employment_types": [
23           {
24             "id": "c5d6e7f8-a9b0-1234-8901-345678901234",
25             "employment_type": {
26               "id": "d6e7f8a9-b0c1-2345-9012-456789012345",
27               "name": "Full-time"
28             }
29           }
30         ],
31         "job_teams": [
32           {
33             "id": "c9d0e1f2-a3b4-5678-2345-789012345678",
34             "team": {
35               "id": "d0e1f2a3-b4c5-6789-3456-890123456789",
36               "name": "Engineering"
37             }
38           }
39         ],
40         "job_departments": [
41           {
42             "id": "e1f2a3b4-c5d6-7890-4567-901234567890",
43             "department": {
44               "id": "f2a3b4c5-d6e7-8901-5678-012345678901",
45               "name": "Product"
46             }
47           }
48         ]
49       },
50       "title": "Senior Engineer",
51       "job_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
52       "publications": [
53         {
54           "id": "f8a9b0c1-d2e3-4567-1234-678901234567",
55           "job_board": {
56             "id": "a9b0c1d2-e3f4-5678-2345-789012345678"
57           },
58           "current_state": {
59             "id": "b0c1d2e3-f4a5-6789-3456-890123456789",
60             "created_at": "2025-03-10T09:00:00.000Z",
61             "created_by": "c1d2e3f4-a5b6-7890-4567-901234567890",
62             "state_slug": "PUBLISHED_BASIC",
63             "error_message": "Error message"
64           }
65         }
66       ],
67       "richtext_description": "<p>Build great products with us.</p>",
68       "is_compensation_visible": "true",
69       "created_at": "2025-01-15T10:30:00.000Z",
70       "updated_at": "2025-02-01T14:00:00.000Z",
71       "application_form": {
72         "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
73         "title": "Default application"
74       }
75     }
76   ],
77   "has_more": "false",
78   "next_cursor": "nextcursorid",
79   "total_count": 3
80 }

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 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

job_board_idstringOptionalformat: "uuid"

Job board to list postings from (UUID).

job_idstringOptionalformat: "uuid"

When set, only postings for this job are returned (UUID).

cursorstringOptional<=1000 characters

Opaque cursor for pagination. Use the value from next_cursor of the previous response to fetch the next page.

limitintegerOptional1-100

Maximum number of job postings to return per page (min: 1, max: 100).

Response

Successful operation. Returns job postings for the requested job board (and optional job filter), with nested job details and publication state per board.

datalist of objects

Job postings returned for this request (single page; pagination not yet implemented).

has_moreboolean

Whether additional pages exist; currently always false for this endpoint.

next_cursorstring or null<=1000 characters

Opaque cursor for the next page; currently always null until pagination is implemented.

total_countinteger>=0

Number of job postings included in data for this response.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

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.

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

Learn more about authentication

AuthorizationBearer

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

Query parameters

job_board_idstringOptionalformat: "uuid"

Job board to list postings from (UUID).

job_idstringOptionalformat: "uuid"

When set, only postings for this job are returned (UUID).

cursorstringOptional<=1000 characters

Opaque cursor for pagination. Use the value from next_cursor of the previous response to fetch the next page.

limitintegerOptional1-100

Maximum number of job postings to return per page (min: 1, max: 100).

Response

Successful operation. Returns job postings for the requested job board (and optional job filter), with nested job details and publication state per board.

datalist of objects

Job postings returned for this request (single page; pagination not yet implemented).

has_moreboolean

Whether additional pages exist; currently always false for this endpoint.

next_cursorstring or null<=1000 characters

Opaque cursor for the next page; currently always null until pagination is implemented.

total_countinteger>=0

Number of job postings included in data for this response.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -G https://api.letsdeel.com/rest/v2/ats/job-postings \
>	-H "Authorization: Bearer <token>" \
>	-d job_board_id=3fa85f64-5717-4562-b3fc-2c963f66afa6 \
>	-d job_id=6ba7b810-9dad-11d1-80b4-00c04fd430c8 \
>	-d cursor=eyJwYWdlIjoyfQ \
>	-d limit=20

1	{
2	"data": [
3	{
4	"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
5	"job": {
6	"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
7	"compensation": {
8	"id": "e7f8a9b0-c1d2-3456-0123-567890123456",
9	"max_amount": 140000,
10	"min_amount": 100000,
11	"currency_iso_code": "USD"
12	},
13	"job_locations": [
14	{
15	"id": "a3b4c5d6-e7f8-9012-6789-123456789012",
16	"location": {
17	"id": "b4c5d6e7-f8a9-0123-7890-234567890123",
18	"name": "London"
19	}
20	}
21	],
22	"job_employment_types": [
23	{
24	"id": "c5d6e7f8-a9b0-1234-8901-345678901234",
25	"employment_type": {
26	"id": "d6e7f8a9-b0c1-2345-9012-456789012345",
27	"name": "Full-time"
28	}
29	}
30	],
31	"job_teams": [
32	{
33	"id": "c9d0e1f2-a3b4-5678-2345-789012345678",
34	"team": {
35	"id": "d0e1f2a3-b4c5-6789-3456-890123456789",
36	"name": "Engineering"
37	}
38	}
39	],
40	"job_departments": [
41	{
42	"id": "e1f2a3b4-c5d6-7890-4567-901234567890",
43	"department": {
44	"id": "f2a3b4c5-d6e7-8901-5678-012345678901",
45	"name": "Product"
46	}
47	}
48	]
49	},
50	"title": "Senior Engineer",
51	"job_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
52	"publications": [
53	{
54	"id": "f8a9b0c1-d2e3-4567-1234-678901234567",
55	"job_board": {
56	"id": "a9b0c1d2-e3f4-5678-2345-789012345678"
57	},
58	"current_state": {
59	"id": "b0c1d2e3-f4a5-6789-3456-890123456789",
60	"created_at": "2025-03-10T09:00:00.000Z",
61	"created_by": "c1d2e3f4-a5b6-7890-4567-901234567890",
62	"state_slug": "PUBLISHED_BASIC",
63	"error_message": "Error message"
64	}
65	}
66	],
67	"richtext_description": "<p>Build great products with us.</p>",
68	"is_compensation_visible": "true",
69	"created_at": "2025-01-15T10:30:00.000Z",
70	"updated_at": "2025-02-01T14:00:00.000Z",
71	"application_form": {
72	"id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
73	"title": "Default application"
74	}
75	}
76	],
77	"has_more": "false",
78	"next_cursor": "nextcursorid",
79	"total_count": 3
80	}

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