# Get run

`GET` `/api/v1/crm-connections/{crm_connection_id}/retrievals/runs/{run_id}`

Returns the run summary, including status, timestamps, definition
reference, market coverage report, flow details, and total assignment
count.

## Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| crm_connection_id | string | yes | UUID of the CRM connection |
| run_id | string | yes | Salesforce ID of the retrieval run |

## Response

`200 OK` — `application/json`

| Field | Type | Description |
|-------|------|-------------|
| id | string | Run record ID |
| definition | object | Retrieval definition that produced this run |
| definition.id | string | Salesforce ID of the definition |
| definition.name | string | Definition name |
| status | string | Run status: Pending, In Progress, Completed, or Failed |
| status_message | string | Status message (typically set on failure) |
| run_source | string | How the retrieval was triggered |
| retrieved_at | string | ISO-8601 timestamp when retrieval ran |
| created_at | string | ISO-8601 creation timestamp |
| updated_at | string | ISO-8601 last-modified timestamp |
| retrieved_count | integer | Total accounts retrieved in this run |
| market_coverage_report | object | Linked market coverage report (null if none) |
| market_coverage_report.id | string | Salesforce ID of the report definition |
| market_coverage_report.name | string | Report name |
| flow | object | Flow execution details (null if no flow fields populated) |
| flow.interview_guid | string | Flow interview GUID |
| flow.name | string | Flow name |
| flow.version | string | Flow version number |
| flow.version_view_durable_id | string | Flow version view durable ID |

## Errors

| Status | Description |
|--------|-------------|
| 400 | Bad Request |
| 403 | Forbidden |
| 404 | Not Found |
| 422 | Unprocessable Entity |
| 502 | Bad Gateway |