---
title: "interviewerPool.list"
method: POST
path: "/interviewerPool.list"
tags: ["Interviewer Pool"]
---

# interviewerPool.list

`POST /interviewerPool.list`

List all interviewer pools.

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

**Requires the [`hiringProcessMetadataRead`](authentication#permissions-interviewerpoollist) permission.**

## Request body

- InterviewerPoolListRequest
  - `cursor` string, nullable — The pagination cursor. Use 'start' for the first page or the nextCursor value from a previous response.
  - `syncToken` string, nullable — A sync token to retrieve only interviewer pools updated since the last sync. Obtained from a previous list response.
  - `limit` number, nullable — The maximum number of interviewer pools to return per page.
  - `includeArchivedPools` boolean, nullable — When true, includes archived pools. Defaults to false.
  - `includeArchivedTrainingStages` boolean, nullable — When true, includes archived training stages. Defaults to true.

## Response `200`

Responses from the interviewerPool.list endpoint

- union
  - InterviewerPoolListSuccessResponse
    - `success` true, required
    - `results` object[], required
      - `id` string, uuid, required — The pool's id
      - `title` string, required — The pool's title
      - `isArchived` boolean, required — Whether the pool is archived
      - `trainingPath` InterviewerPoolTrainingPath, required
        - `id` string, uuid, required — The training path's id
        - `enabled` boolean, required — Whether the training path is enabled
        - `trainingStages` InterviewerPoolTrainingPathStage[], required — The training stages in this path
          - `id` string, uuid, required — The training stage's id
          - `interviewerRole` 'Shadow' | 'ReverseShadow', required — The role of the interviewer for this stage
          - `interviewsRequired` integer, required — The number of interviews required for this stage
          - `isArchived` boolean, required — Whether the training stage is archived
          - `approvalRequired` boolean, required — Whether approval is required for this stage
          - `approvers` User[], nullable, required — The users who can approve this stage
            - `id` string, uuid, required — The unique identifier for the user
            - `firstName` string, required — The user's first name
            - `lastName` string, required — The user's last name
            - `email` string, email, nullable, required — The user's email address
            - `globalRole` 'Organization Admin' | 'Elevated Access' | 'Limited Access' | 'External Recruiter', required — The user's global role in the organization
            - `isEnabled` boolean, required — Whether the user is enabled (not deactivated)
            - `updatedAt` string, required — The timestamp when the user was last updated (ISO 8601 format)
            - `managerId` string, uuid — The unique identifier for the user's manager
            - `customFields` CustomField[] — Custom fields associated with the user (only included when requested)
              - …
    - `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)