Retrieve ATS job postings | Deel

curl -G https://api.letsdeel.com/rest/ats/job-postings \
     -H "Authorization: Bearer <token>" \
     -d job_board_id=a1b2c3d4-e5f6-7890-1234-567890abcdef \
     -d job_id=a1b2c3d4-e5f6-7890-1234-567890abcdef \
     -d cursor=eyJwYWdlIjoyfQ \
     -d limit=20

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
      "job": {
        "id": "5f3cbc4b-2c51-4b48-a2c5-141f581dbf8a",
        "compensation": {
          "id": "9a8b7c6d-5e4f-4321-abcd-9876543210ff",
          "currency_iso_code": "USD",
          "max_amount": 105000,
          "min_amount": 85000
        },
        "job_locations": [
          {
            "id": "ae5ea0d8-300b-4027-9d14-0330ac5e527c",
            "location": {
              "id": "f61a2d36-2790-45d0-b9c9-988c6c234b9b",
              "name": "France"
            }
          }
        ],
        "job_employment_types": [
          {
            "id": "33a13504-ec08-4f2a-98cf-64c0cc20f20b",
            "employment_type": {
              "id": "5ed1ab2a-395f-4cf1-854f-7aa060a31db3",
              "name": "Temporary"
            }
          }
        ],
        "job_teams": [
          {
            "id": "53e4d5bb-65e3-42ff-ada7-65badeeb9d8f",
            "team": {
              "id": "127ee4e0-3776-46c8-8999-5e045e2ae1cf",
              "name": "Product Design Team"
            }
          }
        ],
        "job_departments": [
          {
            "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
            "department": {
              "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
              "name": "Product"
            }
          }
        ]
      },
      "title": "Product Designer",
      "job_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
      "created_at": "2025-07-24T16:28:46.063Z",
      "updated_at": "2025-07-25T10:11:12.613Z",
      "publications": [
        {
          "id": "07e7f02c-e10f-4751-a1af-a7d110617e27",
          "job_board": {
            "id": "95858e6b-3971-408c-97d6-73ca4fce10b7"
          },
          "current_state": {
            "id": "958e9211-5944-49df-a9df-af43967b233f",
            "created_at": "2025-07-24T16:28:46.063Z",
            "state_slug": "PUBLISHED_BASIC",
            "created_by": "42d103ea-9367-432a-8e6f-7ab548eeddcd",
            "error_message": "Publication failed due to invalid job board credentials"
          }
        }
      ],
      "richtext_description": "<p>Some description</p>",
      "is_compensation_visible": false,
      "application_form": {
        "id": "6bfbc928-8d34-46a0-8bca-6503f0e7128c",
        "title": "Standard Application"
      }
    }
  ],
  "has_more": false,
  "next_cursor": "string",
  "total_count": 1
}

List job postings across your organization, optionally filtered by job board or job ID. Omit filters to retrieve all postings; use the job-board-scoped endpoint instead for queries by board alone.

Token scopes: ats:read, worker: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

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

has_moreboolean

Indicates if there are more results available

next_cursorstring or null

Cursor for the next page of results

total_countinteger>=0

Total number of job postings

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'