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

# List workflow runs

`GET /workflow_runs`

## Query parameters

- `page` integer

## Response `200`

Paginated list of runs, newest first

- object[]
  - `uid` string
  - `status` 'queued' | 'running' | 'completed' | 'failed'
  - `workflow` string — UID of the workflow that was run
  - `progress` integer — Percentage of steps completed. A failed run reports how far it got.
  - `inputs` object — Inputs this run was started with
  - `outputs` object — Every completed step's output, keyed by step name
  - `metadata` string, nullable — Arbitrary metadata string round-tripped from the create request
  - `steps` object[]
    - `key` string
    - `type` 'tool' | 'image' | 'animation'
    - `status` 'pending' | 'running' | 'completed' | 'failed' | 'skipped'
    - `output` object — Flattened result of this step, addressable by later steps as {{steps.<key>.<output>}}
    - `error` string — Only present when this step failed
    - `resource` object — The resource this step produced. Absent until the step has dispatched.
      - `type` 'tool_job' | 'image' | 'animation' — Fetch from the matching endpoint — tool_job → /tool_jobs/{uid}
      - `uid` string
  - `error` string — Only present when the run failed
  - `self` string, uri
  - `created_at` string, date-time
  - `completed_at` string, date-time, nullable

---

[API](https://skmtc.dev/bannerbear/apis/bannerbear-v5-api.md) · [All operations](https://skmtc.dev/bannerbear/apis/bannerbear-v5-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bannerbear/bannerbear-v5-api/revisions/6aa425420a10/schema)