> ## 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 Agent Runs

> List recent runs for an agent with pagination and optional status/date filters.

Lists recent runs for one agent.

## Request

```bash theme={null}
curl -X GET "https://api.mosaic.so/agent/[agent_id]/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 (for example: `running,completed`). |
| `from`   | string | No       | ISO timestamp lower bound on `created_at`.                   |
| `to`     | string | No       | ISO timestamp upper bound on `created_at`.                   |

## 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": [
        {
          "id": "7ba7b810-9dad-11d1-80b4-00c04fd430c8",
          "video_url": "https://storage.googleapis.com/mosaic-outputs/...",
          "thumbnail_url": "https://storage.googleapis.com/mosaic-thumbnails/...",
          "premiere_prproj_url": "https://storage.googleapis.com/mosaic-outputs/.../timeline.zip?...",
          "completed_at": "2026-03-02T09:06:00Z",
          "original_node_id": "2ba7b810-9dad-11d1-80b4-00c04fd430c8"
        }
      ],
      "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).