Retrieve a list of ATS applications

List applications: Returns a paginated list of candidate applications for an organization. Use this to track and review the progress of candidates across all open positions. Supports cursor-based pagination and filtering via query parameters. Scope: ats:read 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)
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 by candidate name or email
job_idstringOptionalformat: "uuid"
Filter applications by specific job ID
interview_plan_stage_idslist of stringsOptional
Filter applications by specific interview plan stage IDs
candidate_tag_idslist of stringsOptional
Filter applications by candidate tag IDs
source_slugslist of stringsOptional
Filter applications by source slugs
job_criterias_matchingslist of objectsOptional
Filter applications by job criteria matching state. Each object specifies a job criteria ID and whether the candidate matches it.
current_stage_category_type_slugslist of stringsOptional
Filter applications by current stage category type slugs
current_stage_default_type_slugslist of stringsOptional
Filter applications by current stage default type slugs. 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
has_moreboolean
Indicates if there are more applications to fetch
next_cursorstring or null
Cursor for the next page of results
total_countinteger
Total number of applications available

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error