---
title: getRun
description: Gateway RPC for reading one run.
maturity: stable
apiVersion: v1
---

- Method: `getRun`
- Scope: `run:read`
- Transports: HTTP RPC, WebSocket RPC
- Request: `{ runId }`
- Response: run record with `summary` and optional `runState: RunStateView`

Errors are versioned as `v1` and include `InvalidRequest`, `Unauthorized`, `Forbidden`, `RunNotFound`, and `Internal`.

Use this after a `GapResync` event (see `streamRunEvents`) to rebuild local state from scratch.
