---
title: "Get paginated workflow execution history"
method: GET
path: "/workflow/{id}/history"
---

# Get paginated workflow execution history

`GET /workflow/{id}/history`

Returns decoded Temporal history events with optional payload inclusion. First page includes workflow metadata; subsequent pages return events only.

## Path parameters

- `id` string, required

## Query parameters

- `runId` string
- `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 — Resolved run ID. Echo this value as the runId query parameter when fetching subsequent pages.
  - `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

[Change history](https://skmtc.dev/growthxai/apis/output-ai-api/changes/workflow/:id/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-service-production.skmtc.workers.dev/v1/apis/growthxai/output-ai-api/revisions/09a49e598435/schema)