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

# List Workflow Runs

> List all workflow execution runs with optional filtering.

## Authentication

Requires a JWT token or API key in the `Authorization` header.

```bash theme={"dark"}
Authorization: Bearer YOUR_TOKEN
```

## Request

### Query parameters

<ParamField query="page" type="integer">
  Page number (default: 1).
</ParamField>

<ParamField query="limit" type="integer">
  Items per page (default: 20).
</ParamField>

<ParamField query="workflow_id" type="string">
  Filter runs by a specific workflow.
</ParamField>

### Example request

```bash theme={"dark"}
curl "https://encrata.com/api/workflows/runs?workflow_id=wf_abc123&limit=10" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

## Response

```json theme={"dark"}
{
  "runs": [
    {
      "id": "run_def456",
      "workflow_id": "wf_abc123",
      "workflow_name": "Lead enrichment pipeline",
      "status": "completed",
      "steps_total": 3,
      "steps_completed": 3,
      "credits_used": 2,
      "started_at": "2026-06-01T10:00:00Z",
      "completed_at": "2026-06-01T10:00:05Z",
      "duration_ms": 5200
    }
  ],
  "total": 42,
  "page": 1
}
```

### Run statuses

| Status      | Description                             |
| ----------- | --------------------------------------- |
| `queued`    | Waiting to be picked up by the executor |
| `running`   | Currently executing steps               |
| `completed` | All steps finished successfully         |
| `failed`    | One or more steps failed                |
| `cancelled` | Manually cancelled                      |