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

> Retrieve one browser task or ordered workflow run by ID.

Requires `runs:read`.

<ParamField path="run_id" type="string" required>
  Run identifier returned by create.
</ParamField>

## Response

<ResponseField name="status" type="string" required>
  `queued`, `running`, `completed`, `failed`, or `cancelled`.
</ResponseField>

<ResponseField name="result" type="object | null" required>
  Bounded result when available. Workflow outputs appear under `result.outputs`.
</ResponseField>

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

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

<ResponseField name="step_count" type="integer" required>
  Number of completed execution steps.
</ResponseField>

<Note>
  A successful HTTP response can describe a `failed` or `cancelled` run. Always inspect `status`.
</Note>


## Related topics

- [Create a run](/reference/runs/create.md)
- [Python SDK](/sdks/python.md)
- [CLI](/tools/cli.md)
- [Get a Blueprint run](/reference/blueprint-runs/get.md)
- [Get a Blueprint](/reference/blueprints/get.md)