Retrieve a list of ATS applications

Returns a cursor-paginated list of candidate applications across all open positions for the organization, with filtering by job, interview plan stage, candidate tags, source, stage type, and last-updated timestamp.

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 curl -X GET 'https://api.deel.training/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)
OR
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-100Defaults 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 interview plan stage IDs (comma-separated)

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 (comma-separated)

current_stage_default_type_slugslist of stringsOptional

Filter applications by current stage default type slugs. Use ‘others’ for custom stages (comma-separated)

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