> ## 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 run events

> Poll one bounded display-safe run snapshot after a cursor.

Requires `blueprint_runs:read`.

<ParamField path="run_id" type="uuid" required>
  Blueprint run identifier.
</ParamField>

<ParamField query="after" type="integer">
  Return a snapshot after this non-negative sequence cursor.
</ParamField>

## Response

<ResponseField name="data" type="BlueprintRunEvent[]" required>
  Contains at most one `run.snapshot` event.
</ResponseField>

<ResponseField name="nextCursor" type="integer" required>
  Sequence to supply as `after` on the next poll.
</ResponseField>

Each event contains `sequence`, the constant type `run.snapshot`, and the same display-safe run representation returned by the get endpoint.

<Warning>
  This endpoint never returns internal node events, browser observations, raw tool data, credentials, or provider details.
</Warning>


## Related topics

- [List Blueprint runs](/reference/blueprint-runs/list.md)
- [Python SDK](/sdks/python.md)
- [TypeScript SDK](/sdks/typescript.md)
- [Published Blueprints](/guides/published-blueprints.md)
- [Changelog](/changelog.md)