---
title: "interviewStage.list"
method: POST
path: "/interviewStage.list"
tags: ["Interview Stage"]
---

# interviewStage.list

`POST /interviewStage.list`

List all interview stages for an interview plan in order.

**Requires the [`interviewsRead`](authentication#permissions-interviewstagelist) permission.**

## Request body

- InterviewStageListRequest
  - `interviewPlanId` string, uuid, required — The id of the interview plan to list stages for

## Response `200`

Responses from the interviewStage.list endpoint

- union
  - InterviewStageListSuccessResponse
    - `success` true, required
    - `results` InterviewStage[], required
      - `id` string, uuid, required — The unique identifier for the interview stage
      - `title` string, required — The title of the interview stage
      - `type` string, required — The type of the interview stage (e.g. Active, Archived, Hired, PreInterviewScreen, Offer, Lead)
      - `interviewPlanId` string, uuid, required — The id of the interview plan this stage belongs to
      - `orderInInterviewPlan` integer, required — The order of this stage within its interview plan (zero-indexed)
      - `interviewStageGroupId` string, uuid, nullable, required — The id of the interview stage group this stage belongs to, if any
    - `moreDataAvailable` boolean, required
  - ErrorResponse
    - `success` false, required
    - `errors` ErrorDetail[], required
      - `message` string, required
      - `parameter` string

---

[API](https://skmtc.dev/ashbyhq/apis/ashby-api.md) · [All operations](https://skmtc.dev/ashbyhq/apis/ashby-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ashbyhq/ashby-api/revisions/778b919dc743/schema)