Sign in

v1

latestOpenAPI 3.1.02026-07-261770816.7 KB
Application Stages

List application stages

Application stages are the rows that make up a candidate's stage history on an application — one row per interview stage the application has occupied, with entered_at and exited_at timestamps. An application_stage is the join between an application and a job_interview_stage; the row with exited_at null (and current: true) is the candidate's current stage on that application. Filter with application_ids to retrieve the stage history for specific applications, or job_interview_stage_ids to find every application that has touched a given stage. This endpoint is the canonical source for stage-history reporting; partner BI integrations typically treat it as the fact table.

get/v3/application_stages

Query parameters

cursorstring

Cursor link for pagination from previous page response header. Do not use any other parameters when using this.

per_pageinteger

Number of results per page

idsinteger[]

Comma separated list

gtestring date-time
ltestring date-time
gtstring date-time
ltstring date-time
gtestring date-time
ltestring date-time
gtstring date-time
ltstring date-time
application_idsinteger[]

Comma separated list

job_interview_stage_idsinteger[]

Return only stage entries where the application visited one of these interview stage ids. These are hiring plan interview stage ids (look up the stages on a job via GET /v3/job_interview_stages?job_ids=...); each row represents an application's visit to a stage, not the stage definition itself.

fieldsstring[]

Comma separated list of fields to return

currentboolean

When true, return only the application's current stage entry (the one with exited_at null); when false, only past stage entries. Omit to include the full stage history.

Response

Successful

idinteger
created_atstring date-time
updated_atstring date-time
application_idinteger

Id of the application this stage entry belongs to.

job_interview_stage_idinteger

Id of the interview stage occupied during this entry. References a /v3/job_interview_stages row scoped to the application's job.

entered_atstring date-time nullable

Timestamp the application entered this stage, in ISO 8601. null only for backfilled or partially recorded history.

exited_atstring date-time nullable

Timestamp the application left this stage, in ISO 8601. null while the application is still in this stage (the current stage entry).

days_in_stageinteger

Whole number of calendar days the application has spent in this stage, computed as exited_at - entered_at for past stages and now - entered_at for the current stage.

currentboolean

true when this row represents the application's current interview stage; false for past stage entries in the candidate's history.