Retrieve paginated list of ATS Candidates | Deel

import requests
url = "https://api.letsdeel.com/rest/v2/ats/candidates"
querystring = {"cursor":"cursorValue","limit":"50","search":"John Doe","job_ids":"[\"3fa85f64-5717-4562-b3fc-2c963f66afa6\"]","department_ids":"[\"3fa85f64-5717-4562-b3fc-2c963f66afa6\"]","tag_ids":"[\"3fa85f64-5717-4562-b3fc-2c963f66afa6\"]","current_stage_category_type_slugs":"[\"phone-screen\"]","current_stage_default_type_slugs":"[\"technical-interview\",\"others\"]","updated_after":"2025-06-18T00:00:00.000Z"}
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
      "email": "john.doe@example.com",
      "pic_url": "https://example.com/profile.jpg",
      "last_name": "Doe",
      "created_at": "2023-10-01T12:00:00Z",
      "first_name": "John",
      "numeric_id": 12345,
      "updated_at": "2023-10-02T12:00:00Z",
      "applications": [
        {
          "id": "b1c2d3e4-f5a6-7890-1234-567890abcdef",
          "job": {
            "id": "c1d2e3f4-a5b6-7890-1234-567890abcdef",
            "title": "Software Engineer"
          },
          "created_at": "2024-01-02T00:00:00Z",
          "current_application_interview_plan_stage": {
            "id": "d1e2f3a4-b5c6-7890-1234-567890abcdef",
            "status": "ACTIVE",
            "created_at": "2024-01-03T00:00:00Z",
            "application_id": "e1f2a3b4-c5d6-7890-1234-567890abcdef",
            "interview_plan_stage": {
              "id": "f1a2b3c4-d5e6-7890-1234-567890abcdef",
              "name": "Phone Screen",
              "description": "Initial phone screening with the candidate",
              "stage_order": 1,
              "default_type_slug": "phone-screen",
              "interview_plan_id": "12345678-90ab-cdef-0123-456789abcdef",
              "category_type_slug": "initial"
            },
            "interview_plan_stage_id": "23456789-0abc-def1-2345-67890abcdef0"
          }
        }
      ],
      "phone_number": "+15551234567",
      "candidate_tags": [],
      "final_archivation_at": "2024-01-04T00:00:00Z",
      "linkedin_profile_url": "https://www.linkedin.com/in/johndoe",
      "total_applications_count": 5
    }
  ],
  "has_more": true,
  "next_cursor": "abcdef01-2345-6789-0abc-def012345678",
  "total_count": 100
}

Retrieves a list of candidates in the Applicant Tracking System. You can filter candidates by jobs, departments, and tags to narrow down the results Token scopes: ats:read

Authentication

AuthorizationBearer

Authentication

Deel API uses API tokens to authenticate requests. A bearer token is required to authenticate all API requests. All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail. curl -X GET 'api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE'

## Authentication Deel API uses API tokens to authenticate requests. A bearer token is required to authenticate all API requests. All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail. ``` curl -X GET 'api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` ### Generating Access Tokens 1. Navigate to **Apps & Perks > Developer Center**. 2. Click on the “Generate New Token” button. 3. In the popup, click “Generate Token” button to generate a new token. Your newly generated token is visible on the screen. 4. Make sure to copy and save your token once is generated. You won't be able to see it again!

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

Search text for filtering candidates

job_idslist of stringsOptional

Filter candidates by job IDs

department_idslist of stringsOptional

Filter candidates by department IDs

tag_idslist of stringsOptional

Filter candidates by tag IDs

current_stage_category_type_slugslist of stringsOptional

Filter candidates by current stage category type slugs

current_stage_default_type_slugslist of stringsOptional

Filter candidates by current stage default type slugs

updated_afterstringOptionalformat: "date-time"

Filter applications updated after this timestamp (ISO 8601 format)

Response

Successful operation.

datalist of objects or null

has_moreboolean or null

Indicates if there are more items to fetch.

next_cursorstring or null

Cursor for the next page of results

total_countinteger or null>=0

Total number of candidates

Authentication

Authentication

Query parameters

Response

Errors

Authentication