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
cursor
Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results.
limit
Maximum number of applications to return per page
search_text
Search text to filter applications by candidate name or email
job_id
Filter applications by specific job ID
interview_plan_stage_ids
Filter applications by specific interview plan stage IDs
candidate_tag_ids
Filter applications by candidate tag IDs
source_slugs
Filter applications by source slugs
job_criterias_matchings
Filter applications by job criteria matching state. Each object specifies a job criteria ID and whether the candidate matches it.
current_stage_category_type_slugs
Filter applications by current stage category type slugs
current_stage_default_type_slugs
Filter applications by current stage default type slugs. Use 'others' for custom stages.
updated_after
Filter applications updated after this timestamp (ISO 8601 format)
sort_by
Field to sort applications by
Allowed values:
sort_order
Sort order for applications
Allowed values:
Response
Successfully retrieved applications
data
has_more
Indicates if there are more applications to fetch
next_cursor
Cursor for the next page of results
total_count
Total number of applications available
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error