> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clustr-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Workflow Executions

> A Workflow's run history, newest first

One row per pass: how many records fired, and whether every action delivered.
`filtered` means the pass ran and nothing entered, left, or came due — not a
failure.

## Path Parameters

<ParamField path="id" type="string" required>
  The Workflow's id.
</ParamField>

## Query Parameters

<ParamField query="limit" type="integer" default="20" />

<ParamField query="offset" type="integer" default="0" />

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.clustr-ai.com/api/public/workflows/7f1e2a33-.../executions?limit=10" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "executions": [
        {
          "id": "b2c3d4e5-...",
          "workflow_id": "7f1e2a33-...",
          "status": "success",
          "source": "view",
          "record_count": 3,
          "started_at": "2026-09-13T09:00:00Z",
          "finished_at": "2026-09-13T09:00:04Z"
        }
      ],
      "total": 1,
      "limit": 10,
      "offset": 0
    }
  }
  ```

  ```json 404 theme={null}
  {
    "success": false,
    "error": { "message": "workflow not found", "code": "NOT_FOUND" }
  }
  ```
</ResponseExample>