---
title: "[Beta] List workflow runs"
method: GET
path: "/workflows/{workflow_id}/runs"
tags: ["Workflows (Beta)"]
---

# [Beta] List workflow runs

`GET /workflows/{workflow_id}/runs`

List execution runs for a workflow with filtering and pagination. Filter by status (completed, failed, in_progress, canceled, idle), trigger cause (manual, automatic, scheduled), and search by keyword.

## Path parameters

- `workflow_id` string, required

## Query parameters

- `page` number
- `limit` number
- `status` string
- `trigger_cause` string

## Response `200`

Default Response

- ListWorkflowRunsOutput
  - `runs` WorkflowRunPublicResponseDto[], required
    - `id` string, required — Run UUID
    - `workflow_id` number, required — Workflow version serial ID that was executed
    - `status` 'canceled' | 'completed' | 'failed' | 'idle' | 'in_progress' | 'waiting', nullable, required — Run status: "idle", "in_progress", "completed", "failed", "canceled"
    - `trigger_cause` 'automatic' | 'manual' | 'scheduled', required — What caused the run: "manual", "automatic", "scheduled"
    - `duration_in_seconds` number, nullable, required — How long the run took
    - `run_started_at` string, date-time, nullable, required
    - `run_ended_at` string, date-time, nullable, required
    - `is_test_run` boolean, required — Whether this was a test run
    - `created_at` string, date-time, required
  - `total_items` number, required
  - `total_pages` number, required
  - `has_next_page` boolean, required
  - `current_page` number, required

## Other responses

- `500` — Internal Server Error

---

[API](https://skmtc.net/open/apis/opencx-api.md) · [All operations](https://skmtc.net/open/apis/opencx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/open/opencx-api/revisions/57b06b52302d/schema)