---
title: "List workflow runs"
method: GET
path: "/workflow/runs"
---

# List workflow runs

`GET /workflow/runs`

Returns a list of workflow runs with optional filtering by workflow type

## Query parameters

- `workflowType` string
- `catalog` string
- `limit` integer

## Response `200`

List of workflow runs

- WorkflowRunsResponse
  - `runs` WorkflowRunInfo[]
    - `workflowId` string — Unique identifier for this run
    - `runId` string — The specific run id for this execution
    - `workflowType` string — Name of the workflow definition
    - `status` 'running' | 'completed' | 'failed' | 'cancelled' | 'terminated' | 'timed_out' | 'continued_as_new' — Current run status
    - `startedAt` string, date-time — ISO 8601 timestamp of run start
    - `completedAt` string, date-time, nullable — ISO 8601 timestamp of completion, or null if still running
  - `count` integer — Total number of runs returned

## Other responses

- `400` — Invalid request body, query, or pagination token
- `500` — Internal server error (e.g. Temporal connection failure)

## Changes

- **2026-08-07** `09a49e598435` — 1 warning, 1 info
  - added the new `cancelled` enum value to the `runs/items/status` response property for the response status `200`
  - removed the `canceled` enum value from the `runs/items/status` response property for the response status `200`
- **2026-06-16** `5d02013bc7af` — 1 warning, 1 info
  - added the new `continued_as_new` enum value to the `runs/items/status` response property for the response status `200`
  - removed the `continued` enum value from the `runs/items/status` response property for the response status `200`
- **2026-04-30** `c8798d226c67` — 1 info
  - added the new optional `query` request parameter `catalog`
- **2026-04-24** `c7d8acaec718` — 1 info
  - added the optional property `runs/items/runId` to the response with the `200` status
- **2026-04-24** `01552bfa9579` — 2 breaking, 3 warning
  - added `#/components/schemas/ValidationErrorResponse, #/components/schemas/ErrorResponse` to the response body `oneOf` list for the response status `400`
  - the response's body type changed from `object` to no type for status `400`
  - removed the optional property `error` from the response with the `400` status
  - removed the optional property `issues` from the response with the `400` status
  - …1 more

[Full history](https://skmtc.dev/growthxai/apis/output-ai-api/changes/workflow/runs/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)