---
title: "Get paginated workflow execution history for a specific run"
method: GET
path: "/workflow/{id}/runs/{rid}/history"
---

# Get paginated workflow execution history for a specific run

`GET /workflow/{id}/runs/{rid}/history`

## Request

- Base URL: `http://localhost:3001`
- URL: `http://localhost:3001/workflow/{id}/runs/{rid}/history`
- Auth: none required
- TypeScript: <https://skmtc.dev/growthxai/apis/output-ai-api/docs/workflow/:id/runs/:rid/history/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, required
- `rid` string, uuid, required

## Query parameters

- `pageSize` integer
- `pageToken` string
- `includePayloads` boolean
- `longPollTimeoutMs` integer

## Response `200`

Paginated history events

- object
  - `workflow` object, nullable: Workflow metadata (null on subsequent pages)
  - `events` object[]
  - `runId` string: The pinned run ID
  - `nextPageToken` string, nullable

## Other responses

- `400`: Invalid request body, query, or pagination token
- `404`: Workflow execution, workflow type, or catalog not found
- `500`: Internal server error (e.g. Temporal connection failure)

## Changes

- **2026-07-14** `137cca3e52cc`: 1 info
  - added the new optional `query` request parameter `longPollTimeoutMs`
- **2026-04-24** `01552bfa9579`: 1 info
  - endpoint added
- **2026-03-13** `0f0e49049ef1`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/growthxai/apis/output-ai-api/changes/workflow/:id/runs/:rid/history/get.md)

---

[API](https://skmtc.dev/growthxai/apis/output-ai-api.md) - [All operations](https://skmtc.dev/growthxai/apis/output-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/growthxai/apis/output-ai-api/revisions/d34370cdff2d?raw)