> ## 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 Blueprint runs

> Cursor-page API-triggered Blueprint runs.

Requires `blueprint_runs:read`.

<ParamField query="blueprint_id" type="uuid">
  Filter to runs of one Blueprint.
</ParamField>

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

<ParamField query="cursor" type="string">
  Opaque cursor from the previous page. Maximum 512 characters.
</ParamField>

## Response

<ResponseField name="data" type="BlueprintRun[]" required>
  API-triggered Blueprint runs.
</ResponseField>

<ResponseField name="nextCursor" type="string | null" required>
  Cursor for the next page, or `null` when no further page is available.
</ResponseField>

<Warning>
  Treat cursors as opaque. Do not parse, modify, or reuse them across different filters.
</Warning>


## Related topics

- [List Blueprint run events](/reference/blueprint-runs/events.md)
- [MCP server](/tools/mcp.md)
- [List Blueprints](/reference/blueprints/list.md)
- [List runs](/reference/runs/list.md)
- [Run a Blueprint](/reference/blueprints/run.md)