Retrieve a list of ATS jobs | Deel

curl -G https://api.letsdeel.com/rest/ats/jobs \
     -H "Authorization: Bearer <token>" \
     --data-urlencode closed_after=2026-01-01T00:00:00.000Z \
     --data-urlencode closed_before=2026-03-31T23:59:59.000Z \
     -d cursor=cursorValue \
     -d department_ids=a1b2c3d4-e5f6-7890-1234-567890abcdef \
     -d employment_type_ids=a1b2c3d4-e5f6-7890-1234-567890abcdef \
     -d hiring_member_hou_ids=a1b2c3d4-e5f6-7890-1234-567890abcdef \
     -d interview_plan_id=a1b2c3d4-e5f6-7890-1234-567890abcdef \
     -d job_ids=a1b2c3d4-e5f6-7890-1234-567890abcdef \
     -d limit=50 \
     -d location_ids=a1b2c3d4-e5f6-7890-1234-567890abcdef \
     --data-urlencode opened_after=2026-01-01T00:00:00.000Z \
     --data-urlencode opened_before=2026-03-31T23:59:59.000Z \
     -d search=engineer \
     -d status=OPEN \
     -d status=PAUSED \
     -d team_ids=a1b2c3d4-e5f6-7890-1234-567890abcdef \
     --data-urlencode updated_after=2025-06-18T00:00:00.000Z \
     -d work_arrangements=REMOTE \
     -d work_arrangements=HYBRID

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
      "title": "Software Engineer",
      "status": "OPEN",
      "closed_at": "2026-04-01T17:30:00Z",
      "job_teams": [
        {
          "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
          "team": {
            "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
            "name": "Engineering Team"
          }
        }
      ],
      "opened_at": "2026-01-15T09:00:00Z",
      "created_at": "2023-10-01T12:00:00Z",
      "updated_at": "2023-10-02T12:00:00Z",
      "job_locations": [
        {
          "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
          "location": {
            "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
            "name": "New York"
          }
        }
      ],
      "hiring_members": [
        {
          "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
          "hris_organization_user_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef"
        }
      ],
      "is_confidential": false,
      "job_departments": [
        {
          "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
          "department": {
            "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
            "name": "Sales"
          }
        }
      ],
      "approval_rule_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
      "applications_count": 10,
      "active_pause_period": {
        "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
        "paused_at": "2026-03-01T10:00:00Z"
      },
      "approval_request_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
      "current_compensation": {
        "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
        "job_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
        "max_amount": 120000,
        "min_amount": 80000,
        "period_slug": "ANNUALLY",
        "currency_iso_code": "USD"
      },
      "job_employment_types": [
        {
          "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
          "employment_type": {
            "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
            "name": "Full-time"
          }
        }
      ],
      "richtext_description": "<div>Job description in rich text format</div>",
      "interview_plan_stages": [
        {
          "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
          "name": "Phone Screen",
          "position_number": 1,
          "default_type_slug": "phone_screen",
          "interview_plan_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
          "category_type_slug": "ACTIVE"
        }
      ],
      "work_arrangement_enum": "HYBRID",
      "approval_request_stringified": "Approval request details in string format",
      "created_by_hris_organization_user_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
      "hiring_member_job_permissions_by_type_slug": {
        "hiring_team": "read",
        "job_posting": "write",
        "compensation": "read",
        "interview_plan": "write",
        "application_form_submission": "read",
        "application_form_submission_sensitive_fields": "none"
      }
    }
  ],
  "has_more": false,
  "next_cursor": "string",
  "total_count": 42
}

Lists the jobs of the organization together with every stage of their interview plans. Use it to find a job, or to look up a stage id before filtering applications or interviews by stage, since stage names are customer-defined.

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

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)

job_idslist of stringsOptional

Array of job UUIDs (optional). Returns only these jobs, so a caller holding job ids from another endpoint can resolve them in one request instead of paging the whole list. Omitting it leaves the result set unchanged.

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)

opened_afterstringOptionalformat: "date-time"

Return jobs first opened at or after this timestamp (ISO 8601). Jobs that were never opened are excluded.

opened_beforestringOptionalformat: "date-time"

Return jobs first opened at or before this timestamp (ISO 8601). Jobs that were never opened are excluded.

closed_afterstringOptionalformat: "date-time"

Return jobs closed at or after this timestamp (ISO 8601). Jobs that were never closed are excluded.

closed_beforestringOptionalformat: "date-time"

Return jobs closed at or before this timestamp (ISO 8601). Jobs that were never closed are excluded.

hiring_member_hou_idslist of stringsOptional

Return only jobs on whose hiring team at least one of these HRIS organization users sits. Only narrows the jobs the caller can already see. Callers without ATS admin rights only ever see themselves in hiring_members, even when filtering by someone else.

work_arrangementslist of enumsOptional

Array of work arrangement values to filter by (optional)

Allowed values:

Response

Successful operation.

datalist of objects

Page of jobs.

has_moreboolean

Whether more pages are available.

next_cursorstring or null

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

total_countinteger

Total number of jobs matching filters.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error