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

# List All Agent Runs

> List runs across all agents in your organization.

Returns run summaries across every agent your API key can access.

## Request

```bash theme={null}
curl -X GET "https://api.mosaic.so/agent_runs?limit=25&status=running,completed" \
  -H "Authorization: Bearer mk_your_api_key"
```

## Query Parameters

| Field      | Type   | Required | Description                                     |
| ---------- | ------ | -------- | ----------------------------------------------- |
| `limit`    | number | No       | Page size (`1-100`, default `25`).              |
| `cursor`   | string | No       | Pagination cursor from `next_cursor`.           |
| `status`   | string | No       | Comma-separated statuses (`running,completed`). |
| `from`     | string | No       | ISO timestamp lower bound on `created_at`.      |
| `to`       | string | No       | ISO timestamp upper bound on `created_at`.      |
| `agent_id` | string | No       | Filter runs to one agent ID.                    |

## Response

```json theme={null}
{
  "runs": [
    {
      "run_id": "7f8d9c2b-4a6e-8b3f-1d5c-9e2f3a4b5c6d",
      "agent_id": "123e4567-e89b-12d3-a456-789012345678",
      "status": "completed",
      "status_message": null,
      "started_at": "2026-03-02T09:00:00Z",
      "updated_at": "2026-03-02T09:06:00Z",
      "node_status_counts": {
        "completed": 10,
        "in_progress": 0,
        "failed": 0
      },
      "inputs": [],
      "outputs": [],
      "triggered_by": null
    }
  ],
  "next_cursor": null
}
```

`outputs[]` uses the same shape as [Get Agent Run](/api/agent-runs/get-agent-run), including `premiere_prproj_url` when a Premiere Pro timeline package is attached to the render and `sources[]` when the output contains source citations.

This summary response does **not** include `needs_credits`. To check whether a run is credit-blocked, call [Get Agent Run](/api/agent-runs/get-agent-run) (run-level) and/or [Get Agent Run Nodes](/api/agent-runs/get-agent-run-nodes) (node-level).