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

# interview.list

`POST /interview.list`

List all interviews.

See the [Pagination and Incremental Synchronization](/docs/pagination-and-incremental-sync) guide for detailed usage examples.

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

## Request body

- InterviewListRequest
  - `includeArchived` boolean, nullable — When true, includes archived interviews in the response. Defaults to false.
  - `includeNonSharedInterviews` boolean, nullable — If true, interviews that are associated with specific jobs will be included in the response. Shared interviews that are not associated with a specific job can be scheduled for applications to any job. Interviews that are not shared can only be scheduled for applications to the job they are associated with. Defaults to false.
  - `excludeArchivedScheduleTemplateInterviews` boolean, nullable — If true, interviews local to archived schedule templates are omitted from the response. This parameter only has an effect when `includeNonSharedInterviews` is also set to true. Shared interviews (not associated with any schedule template) are always included regardless of this setting. Defaults to false.
  - `cursor` string, nullable — The pagination cursor. Use 'start' for the first page or the nextCursor value from a previous response.
  - `limit` integer, nullable — The maximum number of interviews to return per page. Maximum is 100.
  - `syncToken` string, nullable — A sync token to retrieve only interviews updated since the last sync. Obtained from a previous list response.

## Response `200`

Responses from the interview.list endpoint

- union
  - InterviewListSuccessResponse
    - `success` true, required
    - `results` Interview[], required
      - `id` string, uuid, required — The unique identifier for the interview
      - `title` string, required — The internal title of the interview
      - `externalTitle` string, required — The title of the interview shown to candidates
      - `type` 'Assessment' | 'Interview' | 'InterviewWithoutSchedule' | 'TakeHome' | 'Debrief', required — The interview definition type, such as Interview, TakeHome, or Debrief
      - `isArchived` boolean, required — Whether the interview is archived
      - `isDebrief` boolean, required — Whether the interview is a debrief
      - `isFeedbackRequired` boolean, required — Whether feedback is required for this interview
      - `isFeedbackRequested` boolean, required — Whether feedback is requested for this interview
      - `instructionsHtml` string, nullable — The interview instructions rendered as HTML
      - `instructionsPlain` string, nullable — The interview instructions rendered as plain text
      - `jobId` string, uuid, nullable — The unique identifier for the job associated with this interview, if any
      - `feedbackFormDefinitionId` string, uuid, required — The unique identifier for the feedback form definition used by this interview
    - `nextCursor` string — Cursor for the next page of results, if available
    - `moreDataAvailable` boolean — Whether more data is available beyond this page
    - `syncToken` string — Sync token to use for future incremental syncs. Only present on the last page.
  - ErrorResponse
    - `success` false, required
    - `errors` ErrorDetail[], required
      - `message` string, required
      - `parameter` string

---

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