> ## 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.

# Get a Blueprint run

> Retrieve status, safe outputs, and failure details for one Blueprint run.

Requires `blueprint_runs:read`.

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

## Response

<ResponseField name="status" type="string" required>
  Current Blueprint run lifecycle state.
</ResponseField>

<ResponseField name="outputs" type="object" required>
  Display-safe named outputs. Empty until outputs are available.
</ResponseField>

<ResponseField name="summary" type="string" required>
  Display-safe run summary.
</ResponseField>

<ResponseField name="errorCode" type="string | null" required>
  Display-safe terminal error code.
</ResponseField>

<ResponseField name="errorMessage" type="string | null" required>
  Display-safe terminal error message.
</ResponseField>

<ResponseField name="revisionId" type="uuid" required>
  Exact published revision executed.
</ResponseField>

Terminal states are `completed`, `failed`, `cancelled`, and `interrupted`.


## Related topics

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