---
title: Get Run
api: GET /brands/{brand_id}/runs/{run_id}
description: "Get the status and progress of a specific pipeline run."
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://docs.boringmarketing.com/llms.txt). Append `.md` to any page URL for its markdown version.

Returns detailed status for a single pipeline run, including current stage and progress detail.

## Path parameters

<ParamField path="brand_id" type="string" required>
  The brand UUID.
</ParamField>

<ParamField path="run_id" type="string" required>
  The run UUID returned from a pipeline trigger.
</ParamField>

## Response

```json
{
  "id": "run-uuid",
  "brand_id": "brand-uuid",
  "kind": "full",
  "status": "running",
  "error": null,
  "started_at": "2026-04-07T10:00:00Z",
  "finished_at": null,
  "meta": {
    "current_stage": "evidence_collection",
    "stage_detail": "analyzing SERPs for family 7 of 12",
    "stage_started_at": "2026-04-07T10:06:42Z"
  }
}
```

## Fields

| Field | Type | Description |
|-------|------|-------------|
| `id` | string | Run UUID |
| `brand_id` | string | Brand UUID |
| `kind` | string | Run kind — see [List Runs](https://docs.boringmarketing.com/api-reference/runs/list) for the full enum |
| `status` | string | `queued`, `running`, `done`, or `failed` |
| `error` | string \| null | Error message if `status=failed` |
| `started_at` | string (ISO 8601) | When the run was accepted |
| `finished_at` | string \| null | When the run reached a terminal state |
| `meta.current_stage` | string \| null | Current pipeline stage string |
| `meta.stage_detail` | string \| null | Human-readable detail for the current stage |
| `meta.stage_started_at` | string \| null | When the current stage began |

| Status | Meaning |
|--------|---------|
| `queued` | Waiting to start |
| `running` | Actively processing — check `meta.current_stage` and `meta.stage_detail` |
| `done` | Completed successfully |
| `failed` | Error occurred — check `error` field |

<Note>
Stage progress lives under `meta`, not at the top level. There is no top-level `stage`, `stage_message`, `created_at`, or `completed_at`.
</Note>

## Example

```bash
curl -H "X-API-Key: $BM_API_KEY" \
  https://api.boringmarketing.com/brands/$BRAND_ID/runs/$RUN_ID
```