---
title: "List application stages"
method: GET
path: "/v3/application_stages"
tags: ["Application Stages"]
---

# List application stages

`GET /v3/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.

## Query parameters

- `cursor` string
- `per_page` integer
- `ids` integer[]
- `created_at` object
  - `gte` string, date-time
  - `lte` string, date-time
  - `gt` string, date-time
  - `lt` string, date-time
- `updated_at` object
  - `gte` string, date-time
  - `lte` string, date-time
  - `gt` string, date-time
  - `lt` string, date-time
- `application_ids` integer[]
- `job_interview_stage_ids` integer[]
- `fields` string[]
- `current` boolean

## Response `200`

Successful

- object[]
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `application_id` integer — Id of the application this stage entry belongs to.
  - `job_interview_stage_id` integer — Id of the interview stage occupied during this entry. References a `/v3/job_interview_stages` row scoped to the application's job.
  - `entered_at` string, date-time, nullable — Timestamp the application entered this stage, in ISO 8601. `null` only for backfilled or partially recorded history.
  - `exited_at` string, 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_stage` integer — 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.
  - `current` boolean — `true` when this row represents the application's current interview stage; `false` for past stage entries in the candidate's history.

---

[API](https://skmtc.dev/greenhouse/apis/auth-api.md) · [All operations](https://skmtc.dev/greenhouse/apis/auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greenhouse/auth-api/revisions/9517a2e54640/schema)