atsApplications

Retrieve a list of ATS applications

Use this endpoint to trace where candidates stand in the hiring pipeline and how they got there — every interview plan stage an application has reached and when it entered and left each one.

Token scopes: ats:read, worker:read

get/ats/applications

Request

  • Base URL: https://api.letsdeel.com/rest
  • URL: https://api.letsdeel.com/rest/ats/applications
  • Auth: HTTP bearer

Query parameters

cursorstring

Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results.

limitinteger

Maximum number of applications to return per page

search_textstring

Search text to filter applications

job_idstring uuid

Filter by job ID

interview_plan_stage_idsstring[]

Filter by the CURRENT interview plan stage IDs (comma-separated). Applications that have since moved to another stage are excluded — use reached_interview_plan_stage_ids for those.

reached_interview_plan_stage_idsstring[]

Filter by interview plan stage IDs the application has EVER been in (comma-separated), including applications that have since advanced, been hired or been archived.

moved_to_current_stage_beforestring date-time

Return only applications that moved to their current stage strictly before this ISO 8601 datetime (stalled candidates)

archivation_reason_idsstring[]

Filter by archivation reason IDs (comma-separated); see GET /rest/ats/reasons with reason_group_slug=CANDIDATE_ARCHIVATION

candidate_tag_ids_operator'ANY' | 'ALL'

How candidate_tag_ids are combined: ANY (default) matches candidates with at least one of the tags, ALL requires every tag

includeAtsApplicationsGetParametersIncludeSchemaItems[]

Optional expansions to embed on each item. STAGE_HISTORY adds the full stage timeline with entered/exited timestamps.

candidate_tag_idsstring[]

Filter by candidate tag IDs (comma-separated)

source_slugsstring[]

Filter by application source (comma-separated)

is_matched'MATCHED' | 'NOT_MATCHED' | 'UNDECIDED' required
job_criteria_idstring uuid required

Filter applications by job criteria matching state

current_stage_category_type_slugsstring[]

Filter applications by current stage category type slugs (comma-separated)

current_stage_default_type_slugsstring[]

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

updated_afterstring date-time

Filter applications updated after this timestamp (ISO 8601 format)

sort_by'APPLICATION_CREATION_DATE' | 'STAGE_CREATION_DATE'

Field to sort applications by

sort_order'ASC' | 'DESC'

Sort order for applications

Response

Successfully retrieved applications

has_moreboolean required

Whether more pages are available

next_cursorstring nullable required

Cursor to fetch the next page; null when there are no more pages

total_countinteger required

Total number of applications

Changes

No recorded changes to this operation across all 1 revision of this API.