Retrieve a list of ATS applications

GET

/ats/applications

GET

/rest/ats/applications

curl -G https://api.letsdeel.com/rest/ats/applications \
     -H "Authorization: Bearer <token>" \
     -d archivation_reason_ids=5b1f7a0e-2c3d-4e5f-8a9b-0c1d2e3f4a5b \
     -d candidate_tag_ids=c8a7d362-6960-4f75-98d3-5118df39c84c \
     -d candidate_tag_ids=06ace055-faf4-4436-a148-76e58ee95d13 \
     -d candidate_tag_ids_operator=ANY \
     -d current_stage_category_type_slugs=lead \
     -d current_stage_category_type_slugs=active \
     -d current_stage_default_type_slugs=new_lead \
     -d current_stage_default_type_slugs=screening \
     -d cursor=eyJsYXN0Q3JlYXRlZEF0IjoiMjAyNS0wNi0xOFQwOToxNzoyMi40NDFaIiwibGFzdElkIjoiMWVhOTlmMzYtZWEzYy00N2QyLWI3NDAtNmFkNTM2ZjU4OTI4In0 \
     -d include=STAGE_HISTORY \
     -d interview_plan_stage_ids=29e13ec4-d41d-43a6-aca2-bb22b06f4ab2 \
     -d interview_plan_stage_ids=2e8deac2-5d0f-4561-81fc-d1903390de29 \
     -d "job_criterias_matchings[is_matched]=MATCHED" \
     -d "job_criterias_matchings[job_criteria_id]=f8a7d362-6960-4f75-98d3-5118df39c84c" \
     -d job_id=f47ac10b-58cc-4372-a567-0e02b2c3d479 \
     -d limit=25 \
     --data-urlencode moved_to_current_stage_before=2025-06-01T00:00:00Z \
     -d reached_interview_plan_stage_ids=29e13ec4-d41d-43a6-aca2-bb22b06f4ab2 \
     --data-urlencode "search_text=john doe" \
     -d sort_by=APPLICATION_CREATION_DATE \
     -d sort_order=DESC \
     -d source_slugs=sourced_internally \
     -d source_slugs=linkedin_premium \
     --data-urlencode updated_after=2025-06-18T00:00:00.000Z

{
  "data": [
    {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "created_at": "2025-06-18T13:04:03.920Z",
      "numeric_id": 183,
      "moved_to_current_stage_at": "2025-06-18T13:04:04.805Z",
      "job": {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "title": "Senior Product Designer"
      },
      "hired_at": "2026-06-01T09:00:00Z",
      "candidate": {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "email": "john.doe@example.com",
        "pic_url": "https://example.com/profile.jpg",
        "last_name": "Doe",
        "first_name": "John",
        "phone_number": "+1234567890",
        "candidate_tags": [
          {
            "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
            "tag": {
              "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
              "label": "Top talent"
            }
          }
        ],
        "city": "San Francisco",
        "country_code": "US"
      },
      "updated_at": "2025-06-25T09:30:00.000Z",
      "job_posting": {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "title": "Product Designer - Remote"
      },
      "source_slug": "INTERNAL_CAREER_PAGE",
      "stage_history": [
        {
          "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "exited_at": "2025-06-25T09:30:00.000Z",
          "entered_at": "2025-06-18T13:04:04.805Z",
          "is_current": false,
          "interview_plan_stage": {
            "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
            "name": "Technical Interview",
            "position_number": 2100,
            "default_type_slug": "offer",
            "category_type_slug": "active"
          },
          "moved_by_hris_organization_user_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
        }
      ],
      "job_employment_type": {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "employment_type": {
          "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "name": "Full-time"
        }
      },
      "submitter_ip_address": "203.0.113.42",
      "submitter_user_agent": "Mozilla/5.0...",
      "archivation_reason_id": "9b2d1c1e-7f3a-4c58-9e2b-3f1a2b4c5d6e",
      "application_form_submission": {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "answers": [
          {
            "answer": "John Doe",
            "question_text": "Full Name",
            "question_type": "FREETEXT",
            "data_binding_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
          }
        ]
      },
      "application_job_criterias_matchings": [
        {
          "id": "a7b8c9d0-e1f2-3456-789a-bcdef1234567",
          "is_matched": "MATCHED",
          "description": "5+ years of experience with design systems",
          "job_criteria_id": "b8c9d0e1-f2a3-4567-89ab-cdef12345678"
        },
        {
          "id": "b8c9d0e1-f2a3-4567-89ab-cdef12345679",
          "is_matched": "MATCHED",
          "description": "Experience with Figma and prototyping tools",
          "job_criteria_id": "c9d0e1f2-a3b4-5678-9abc-def123456789"
        },
        {
          "id": "c9d0e1f2-a3b4-5678-9abc-def12345678a",
          "is_matched": "UNDECIDED",
          "description": "Portfolio demonstrating UX research skills",
          "job_criteria_id": "d0e1f2a3-b4c5-6789-abcd-ef123456789a"
        }
      ],
      "created_by_hris_organization_user_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "current_application_interview_plan_stage": {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "application_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "interview_plan_stage": {
          "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "name": "New lead",
          "position_number": 2001,
          "default_type_slug": "new_lead",
          "category_type_slug": "lead"
        },
        "interview_plan_stage_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
      },
      "current_application_interview_plan_stage_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "application_form_form_builder_form_submission_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
    }
  ],
  "has_more": true,
  "next_cursor": "eyJsYXN0Q3JlYXRlZEF0IjoiMjAyNS0wNi0xOFQxMzowNDowMy45MjBaIiwibGFzdElkIjoiZjYyODE2MjAtOTNiZS00NWZiLWFiOTEtZGQxZDhjZDg5Mzk1In0=",
  "total_count": 150
}

Use this endpoint to trace where candidates stand in the hiring pipeline and how they got there — every interview plan stage an application has reached and when it entered and left each one.

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<=1000 characters

Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results.

limitintegerOptional1-500Defaults to 20

Maximum number of applications to return per page

search_textstringOptional<=500 characters

Search text to filter applications

job_idstringOptionalformat: "uuid"

Filter by job ID

interview_plan_stage_idslist of stringsOptional

Filter by the CURRENT interview plan stage IDs (comma-separated). Applications that have since moved to another stage are excluded — use reached_interview_plan_stage_ids for those.

reached_interview_plan_stage_idslist of stringsOptional

Filter by interview plan stage IDs the application has EVER been in (comma-separated), including applications that have since advanced, been hired or been archived.

moved_to_current_stage_beforestringOptionalformat: "date-time"

Return only applications that moved to their current stage strictly before this ISO 8601 datetime (stalled candidates)

archivation_reason_idslist of stringsOptional

Filter by archivation reason IDs (comma-separated); see GET /rest/ats/reasons with reason_group_slug=CANDIDATE_ARCHIVATION

candidate_tag_ids_operatorenumOptional

How candidate_tag_ids are combined: ANY (default) matches candidates with at least one of the tags, ALL requires every tag

Allowed values:

includelist of enumsOptional

Optional expansions to embed on each item. STAGE_HISTORY adds the full stage timeline with entered/exited timestamps.

Allowed values:

candidate_tag_idslist of stringsOptional

Filter by candidate tag IDs (comma-separated)

source_slugslist of stringsOptional

Filter by application source (comma-separated)

job_criterias_matchingslist of objectsOptional

Filter applications by job criteria matching state

current_stage_category_type_slugslist of stringsOptional

Filter applications by current stage category type slugs. Accepted values are lead, active and completed, in either case — the job list reports them uppercase and this filter accepts that form too.

current_stage_default_type_slugslist of stringsOptional

Filter applications by current stage default type slugs (e.g. new_lead, application_review, offer, hired, archived), in either case. Use ‘others’ for custom stages.

updated_afterstringOptionalformat: "date-time"

Filter applications updated after this timestamp (ISO 8601 format)

sort_byenumOptional

Field to sort applications by

Allowed values:

sort_orderenumOptional

Sort order for applications

Allowed values:

Response

Successfully retrieved applications

datalist of objects

Page of applications

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 applications

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error