---
title: "List Workflow Runs"
method: GET
path: "/workflows/runs"
tags: ["Workflow"]
---

# List Workflow Runs

`GET /workflows/runs`

List recent workflow runs for the organization, sorted by most recent first. Optionally filter by `status` (`running`, `completed`, `cancelled`, or `active` for queued+running) and `workflow_id`.

## Query parameters

- `status` string, nullable — Filter by status or use 'active' for queued+running
- `workflow_id` string, nullable — Filter by specific workflow ID
- `limit` integer

## Headers

- `x-api-key` string, nullable

## Response `200`

Successful Response

- WorkflowRunResponse[]
  - `job_id` string, required — Job (run) identifier.
  - `workflow_id` string, required — Workflow identifier.
  - `workflow_name` string — Workflow name at the time of the run.
  - `status` string, required — Current status (e.g. queued, running, completed, failed).
  - `step` string, nullable — Current authoring step from the workflow.
  - `user_id` string, nullable — User who created the workflow.
  - `created_at` string, date-time, nullable — Timestamp when the record was created.
  - `updated_at` string, date-time, nullable — Timestamp when the record was last updated.
  - `queued_at` string, date-time, nullable — Timestamp when the run was enqueued.
  - `started_at` string, date-time, nullable — Timestamp when execution started.
  - `completed_at` string, date-time, nullable — Timestamp when execution finished.
  - `duration_ms` integer, nullable — Total run duration in milliseconds.
  - `status_reason` string, nullable — Short reason explaining the current status.
  - `error_message` string, nullable — Error message if the operation failed.
  - `metrics` object, nullable — Aggregate run metrics (rows in/out, costs, etc.).
  - `blocks` unknown
  - `blocks_count` integer — Number of blocks in the workflow at run time.

## Other responses

- `400` — Request was rejected by the route's validation rules.
- `401` — Missing or invalid API key.
- `403` — Caller does not have access to this workflow.
- `404` — Workflow, run, or job not found.
- `409` — Workflow with the supplied ID already exists.
- `422` — Request body failed validation.
- `500` — Unexpected server error. Retry with backoff.

---

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