List candidates | Deel | Documentation

curl -G https://api.letsdeel.com/rest/talent/candidates \
     -H "X-Beta: true" \
     -H "Authorization: Bearer <token>" \
     -d cursor=eyJhZnRlcklkIjoxMjM0fQ \
     -d limit=10 \
     -d requisition_ids=3cfbb359-6084-46c0-9d3f-1ed1a1007a7a \
     -d status=PENDING_INTERVIEW \
     -d vendor_ids=8a1f0c74-2b16-4f8e-9a0d-5c3e7b219d44 \
     -d vendor_ids=external_provider

{
  "data": [
    {
      "id": "5f2b8c91-77d4-4a3e-8b6c-0e1d9a4f2c38",
      "email": "grace.hopper@example.com",
      "status": "PENDING_INTERVIEW",
      "vendor": {
        "id": "8a1f0c74-2b16-4f8e-9a0d-5c3e7b219d44",
        "name": "Acme Staffing"
      },
      "full_name": "Grace Hopper",
      "last_name": "Hopper",
      "created_at": "2026-07-01T10:15:00.000Z",
      "first_name": "Grace",
      "requisition_id": "3cfbb359-6084-46c0-9d3f-1ed1a1007a7a",
      "creation_source": "VMS_VENDOR",
      "status_updated_at": "2026-08-20T16:45:00.000Z"
    }
  ],
  "page": {
    "cursor": "eyJhZnRlcklkIjoxMjM0fQ",
    "total_rows": 42
  }
}

Returns a cursor-paginated list of the candidates submitted to the Deel Talent job requests of the organization, with their pipeline status and the talent partner that sourced them, newest first. Filter by status, job request or talent partner. Pass the cursor from each response to retrieve the next page, and keep requesting until data is empty.

Token scopes: talents:read

Beta: this version requires the X-Beta: true request header and its contract may change before it is promoted to stable. It is scheduled to become stable on 2027-01-29.

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

statuslist of enumsOptionalDefaults to []

Filter by candidate status.

requisition_idslist of stringsOptionalDefaults to []

Filter by job request identifiers.

vendor_idslist of stringsOptionalDefaults to []

Filter by talent partner identifiers. The reserved value external_provider matches candidates sourced from an external provider rather than a Deel talent partner.

cursorstringOptional<=64 charactersDefaults to

Opaque cursor returned by the previous page. Omit to retrieve the first page.

limitintegerOptional1-100Defaults to 10

Maximum number of records to return.

Response

Successful operation.

datalist of objects

The candidates on the requested page.

pageobject

Pagination details.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

Authentication

Authentication

Headers

Query parameters

Response

Errors