> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a run

> Read the planning details of one run, including requested and planned item counts and the number of attempt records. Use the Location from a run start.

Returns planning metadata for one run belonging to your workspace and team.
This is the resource identified by the `Location` header from
[Start a run](https://docs.qwairy.co/developers/endpoints/runs/manage.md).
Read access is available from Growth and Agency Growth.

**Authorization** `string` *required*

Bearer token for your team.

**brandId** `string` *required*

Workspace identifier. The workspace must belong to the token's team.

**runId** `string` *required*

Run identifier returned by a run creation or list request.

## Response

Returns `200`, `success: true`, `run` and
`Cache-Control: private, no-store`.

| Run field | Meaning |
| - | - |
| `id`, `purpose`, `priority` | Run identity and scheduling category |
| `promptCount`, `modelCount` | Requested target dimensions |
| `requestedCount`, `plannedCount` | Number of requested and planned work items |
| `attemptCount` | Number of attempt records, not completed answers |
| `planningCompletedAt` | ISO 8601 planning completion time, or null |
| `planningFailed` | Whether planning recorded a failure |
| `createdAt`, `updatedAt` | ISO 8601 timestamps |

> [!NOTE]
>
> Planning completion does not mean all answers have finished. This response has
> no overall run status or completion percentage. Use [List
> runs](https://docs.qwairy.co/developers/endpoints/runs/list.md) for `status`, outcome counts and
> `progressPercentage`.

## Synthetic request and response

```bash theme={null}
curl "https://www.qwairy.co/api/v1/brands/$BRAND_ID/runs/$RUN_ID" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN"
```

```json theme={null}
{
  "success": true,
  "run": {
    "id": "55555555-0000-4000-8000-000000000000",
    "purpose": "MANUAL",
    "priority": "URGENT",
    "promptCount": 12,
    "modelCount": 2,
    "requestedCount": 24,
    "plannedCount": 24,
    "attemptCount": 24,
    "planningCompletedAt": "2026-09-01T09:00:01.000Z",
    "planningFailed": false,
    "createdAt": "2026-09-01T09:00:00.000Z",
    "updatedAt": "2026-09-01T09:00:01.000Z"
  }
}
```

## Errors

An inaccessible workspace returns `404 BRAND_NOT_FOUND`; an inaccessible run
returns `404 RESOURCE_NOT_FOUND`. See [Error codes](https://docs.qwairy.co/developers/errors.md)
and honor `Retry-After` on `429`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.