Retrieve a list of ATS jobs

GET

/ats/jobs

GET

/rest/ats/jobs

curl -G https://api.letsdeel.com/rest/ats/jobs \
     -H "Authorization: Bearer <token>" \
     -d cursor=cursorValue \
     -d department_ids=a1b2c3d4-e5f6-7890-1234-567890abcdef \
     -d employment_type_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 \
     -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",
      "job_teams": [
        {
          "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
          "team": {
            "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
            "name": "Engineering Team"
          }
        }
      ],
      "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,
      "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
}

Use this endpoint to resolve a job’s interview plan stages: every stage of the plan is returned, and because stage names are customer-defined you look up a stage’s id here before filtering applications or interviews by stage. Pass a set of job ids to resolve a known group of jobs in one call instead of paging the full list.

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.letsdeel.com/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)

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