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

# List Workflow Runs

`GET /v2/workflows/runs`

## Request

- Base URL: `https://api.stuut.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stuut.ai/v2/workflows/runs`
- Auth: HTTP bearer

List existing generic workflow run records for Stuut administrators.

## Query parameters

- `page` integer: Page number, 0 indexed.
- `limit` integer: Number of records per page.
- `workflow_id` string
- `status` 'pending' | 'running' | 'succeeded' | 'failed' | 'cancelled'
- `source_type` 'event' | 'schedule'
- `action_type` string
- `entity_type` string
- `entity_id` string
- `search` string
- `created_after` string, date-time
- `created_before` string, date-time

## Response `200`

Successful Response

- PaginatedResponseWorkflowRunListItem
  - `data` WorkflowRunListItem[], required: The list of records.
    - `created_at` string, date-time, required
    - `modified_at` string, date-time, required
    - `id` string, required
    - `workflow_id` string, required
    - `workflow_name` string, required
    - `trigger_id` string, required
    - `status` 'pending' | 'running' | 'succeeded' | 'failed' | 'cancelled', required
    - `source` WorkflowExecutionSource, required
      - `source_type` 'event' | 'schedule', required
      - `name` string, required
      - `event_id` string
      - `occurred_at` string, date-time
    - `trigger_entity_type` string: Entity type that caused the trigger to fire.
    - `trigger_entity_id` string: Entity ID that caused the trigger to fire.
    - `trigger_entity` WorkflowRunEntitySummary
      - `label` string, required
      - `customer_id` string, nullable, required
      - `customer_name` string, nullable, required
      - `payment_plan_id` string, nullable, required
      - `due_date` string, date, nullable, required
    - `action_types` string[]
    - `started_at` string, date-time
    - `completed_at` string, date-time
    - `duration_ms` integer
    - `object` string, required: String representing the object's type. Objects of the same type share the same value.
  - `current_page` integer, required: The current page.
  - `total_records` integer, nullable, required: Total number of records.
  - `next_page` integer, nullable, required: The next page number, if one exists.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/stuut/apis/stuut-api.md) - [All operations](https://skmtc.dev/stuut/apis/stuut-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stuut/apis/stuut-api/revisions/ff0ad16a55ff?raw)