---
title: "closeReason.list"
method: POST
path: "/closeReason.list"
tags: ["Close Reason"]
---

# closeReason.list

`POST /closeReason.list`

Lists all close reasons for jobs or openings.

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

## Request body

- CloseReasonListRequest
  - `includeArchived` boolean, nullable — Whether to include archived close reasons in the response.

## Response `200`

Responses from the closeReason.list endpoint

- union
  - CloseReasonListSuccessResponse
    - `success` true, required
    - `results` CloseReason[], required
      - `id` string, uuid, required — The reason's unique id
      - `reasonText` string, required — The text of the reason
      - `isArchived` boolean, required — Whether the close reason has been archived
    - `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)