---
title: "List Runs"
method: GET
path: "/workflows/{workflow_id}/runs"
tags: ["Workflows::Run"]
---

# List Runs

`GET /workflows/{workflow_id}/runs`

List automation runs for a workflow. Supports filtering by `contact_id` and `status`.
Only standard automation runs are returned (survey runs excluded).

## Path parameters

- `workflow_id` string, required

## Query parameters

- `after` string
- `sort_order` 'asc' | 'desc'
- `sort_property` 'id' | 'updated_at'
- `filter` object
  - `contact_id` union — Integer database id or obfuscated public_id.
    - integer
    - string
  - `status` 'active' | 'paused' | 'completed' | 'canceled' — Filter by derived run status.

## Response `200`

OK

- WorkflowsRunAttributes[]
  - `id` integer — Run ID
  - `public_id` string, nullable — Obfuscated run ID
  - `workflow_id` integer — Integer ID of the parent workflow
  - `contact_id` integer, nullable — Raw integer ID of the enrolled contact
  - `current_step_id` integer, nullable — Raw integer ID of the step the run is currently at. Null when not at a step.
  - `event_id` integer, nullable — Raw integer ID of the triggering event that started this run, if any.
  - `type` string, nullable — STI type column. Always `null` for standard automation runs (the only subtype the list endpoint returns).
  - `status` 'active' | 'paused' | 'completed' | 'canceled' — Derived execution status.
  - `skip_communication` boolean — When true, communication steps (send email, etc.) are skipped for this run.
  - `completed_at` string, date-time, nullable — Timestamp when the run completed. Null if still in progress.
  - `paused_at` string, date-time, nullable — Timestamp when the run was last paused. Null if never paused.
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity

---

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