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

# List runs

> List browser task and ordered workflow runs in the API key's workspace.

Requires `runs:read`.

<ParamField query="limit" default="25" type="integer">
  Number of runs to return. Minimum 1; maximum 100.
</ParamField>

<ParamField query="offset" default="0" type="integer">
  Zero-based offset. Maximum 1,000,000.
</ParamField>

## Response

<ResponseField name="data" type="CloudRun[]" required>
  Bounded array of browser task and workflow runs.
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "5d7b1f8a-...",
        "runtime": "modal",
        "status": "completed",
        "task": "Summarize example.com",
        "workflow": null,
        "result": {
          "status": "completed",
          "summary": "Example Domain is a placeholder website.",
          "steps": 3,
          "final_url": "https://example.com/",
          "events": []
        },
        "error_code": null,
        "error_message": null,
        "metadata": {},
        "step_count": 3,
        "created_at": "2026-08-15T20:00:00Z",
        "started_at": "2026-08-15T20:00:01Z",
        "completed_at": "2026-08-15T20:00:08Z",
        "updated_at": "2026-08-15T20:00:08Z"
      }
    ]
  }
  ```
</ResponseExample>


## Related topics

- [TypeScript SDK](/sdks/typescript.md)
- [List Blueprint runs](/reference/blueprint-runs/list.md)
- [List Blueprint run events](/reference/blueprint-runs/events.md)
- [List Blueprints](/reference/blueprints/list.md)
- [List API keys](/reference/api-keys/list.md)