Get Run

GEThttps://api.boringmarketing.com/brands/{brand_id}/runs/{run_id}

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

Path parameters

brand_idstringrequired

The brand UUID.

run_idstringrequired

The run UUID returned from a pipeline trigger.

Response

{
  "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 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

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

Example

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