---
title: "archiveReason.list"
method: POST
path: "/archiveReason.list"
tags: ["Archive Reason"]
---

# archiveReason.list

`POST /archiveReason.list`

Lists archive reasons.

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

## Request body

- ArchiveReasonListRequest
  - `includeArchived` boolean, nullable — When true, includes archived archive reasons in the response. Defaults to false.

## Response `200`

Responses from the archiveReason.list endpoint

- union
  - ArchiveReasonListSuccessResponse
    - `success` true, required
    - `results` ArchiveReason[], required
      - `id` string, uuid, required — The unique identifier for the archive reason
      - `text` string, required — The display text for the archive reason
      - `reasonType` 'RejectedByCandidate' | 'RejectedByOrg' | 'Other', required — The category of archive reason
      - `isArchived` boolean, required — Whether the archive reason is archived
  - 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)