---
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)

---

[API](https://skmtc.net/growthxai/apis/output-ai-api.md) · [All operations](https://skmtc.net/growthxai/apis/output-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/growthxai/output-ai-api/versions/09a49e598435/schema)