Retrieve paginated list of ATS Candidates | Deel

curl -G https://api.letsdeel.com/rest/v2/ats/candidates \
     -H "Authorization: Bearer <token>" \
     -d cursor=cursorValue \
     -d limit=50 \
     --data-urlencode "search=John Doe" \
     -d job_ids=3fa85f64-5717-4562-b3fc-2c963f66afa6 \
     -d department_ids=3fa85f64-5717-4562-b3fc-2c963f66afa6 \
     -d tag_ids=3fa85f64-5717-4562-b3fc-2c963f66afa6 \
     -d current_stage_category_type_slugs=phone-screen \
     -d current_stage_default_type_slugs=technical-interview \
     -d current_stage_default_type_slugs=others \
     --data-urlencode updated_after=2025-06-18T00:00:00.000Z

{
  "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
}

Returns a paginated list of candidates, optionally filtered by job IDs, department IDs, tag IDs, current stage category or default type slugs, or a timestamp to return only records updated after a given point. Token scopes: ats: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 curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/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

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

has_moreboolean

Indicates if there are more items to fetch.

next_cursorstring or null

Cursor for the next page of results

total_countinteger>=0

Total number of candidates

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

1	curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2	-H 'Authorization: Bearer YOUR-TOKEN-HERE'