List job openings | Deel

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

{
  "data": [
    {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "title": "Senior Software Engineer",
      "status": "OPEN",
      "created_at": "2026-01-15T08:00:00Z",
      "updated_at": "2026-01-20T14:30:00Z",
      "opening_prefix": "ENG",
      "opening_type_slug": "NEW_HIRE",
      "opening_numeric_id": 42,
      "team": {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "name": "Backend Engineering"
      },
      "job_ids": [
        "f47ac10b-58cc-4372-a567-0e02b2c3d479"
      ],
      "team_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "location": {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "name": "New York",
        "country": "US"
      },
      "filled_at": "2026-03-20T12:00:00Z",
      "opened_at": "2026-01-15T09:00:00Z",
      "location_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "employment_type": {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "name": "Full-time"
      },
      "filled_by_offer": {
        "start_date": "2026-09-01T00:00:00Z",
        "offer_status_enum": "ACCEPTED"
      },
      "is_confidential": false,
      "target_hire_date": "2026-09-01T00:00:00Z",
      "target_start_date": "2026-10-01T00:00:00Z",
      "employment_type_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "compensation_period": "yearly",
      "filled_by_application": {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "candidate": {
          "last_name": "Doe",
          "first_name": "Jane"
        }
      },
      "max_compensation_amount": "120000.0000",
      "min_compensation_amount": "80000.0000",
      "filled_by_application_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "compensation_currency_iso_code": "USD",
      "recruiter_hris_organization_user_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "created_by_hris_organization_user_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "updated_by_hris_organization_user_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
    }
  ],
  "has_more": false,
  "next_cursor": "eyJpZCI6IjEyMzQifQ==",
  "total_count": 42
}

Lists the headcount openings (requisitions), that is the positions that jobs are hiring for. Use it to review that headcount and to see which hire filled each opening. Callers with restricted access see only the openings they may view.

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

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:

recruiter_hris_organization_user_idslist of stringsOptional

Return only openings whose recruiter is one of these HRIS organization users (up to 100).

created_by_hris_organization_user_idslist of stringsOptional

Return only openings created by one of these HRIS organization users (up to 100).

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