---
title: "application.listHistory"
method: POST
path: "/application.listHistory"
tags: ["Application"]
---

# application.listHistory

`POST /application.listHistory`

Fetch a paginated list of application history items for an application.

This endpoint supports pagination only (not incremental sync). See the [Pagination and Incremental Synchronization](/docs/pagination-and-incremental-sync) guide for usage examples.

**Requires the [`candidatesRead`](authentication#permissions-applicationlisthistory) permission.**

## Request body

- ApplicationListHistoryRequest
  - `applicationId` string, uuid, required — The id of the application to fetch.
  - `cursor` string, nullable — The pagination cursor. Use 'start' for the first page or the nextCursor value from a previous response.
  - `limit` number, nullable — The maximum number of history events to return per page.

## Response `200`

Responses from the application.listHistory endpoint

- union
  - ApplicationListHistorySuccessResponse
    - `success` true, required
    - `results` ApplicationHistory[], required
      - `id` string, uuid, required — The unique identifier for the history event
      - `stageId` string, uuid, required — The id of the interview stage for this event
      - `title` string, required — The interview stage title for this event
      - `enteredStageAt` string, date-time, required — The timestamp the application entered this stage
      - `leftStageAt` string, date-time, nullable — The timestamp the application left this stage, if any
      - `stageNumber` integer, required — The order of the history event in the application's history. 0 is the first event.
      - `allowedActions` string[], required — Actions that can be performed on this history event via `application.updateHistory`.
      - `actorId` string, uuid, nullable — The ID of the user that performed the stage change, if any.
    - `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)