---
title: "Runs"
method: GET
path: "/accounts/{account}/runs"
tags: ["Runs"]
---

# Runs

`GET /accounts/{account}/runs`

## Request

- Base URL: `https://app.broadcastwell.com/api/v1`
- URL: `https://app.broadcastwell.com/api/v1/accounts/{account}/runs`
- Auth: HTTP bearer

Every measurement the account holds, newest first, with its passes. Scheduled passes carry the figures. Adaptive passes are labelled.

## Path parameters

- `account` string, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

A page of runs

- object
  - `sample` boolean: Present and true on every sample response.
  - `data` Run[], required
    - `run_id` string, required
    - `kind` string, required
    - `status` string, required
    - `method_version` string
    - `immutable` boolean
    - `question_count` integer
    - `engines` unknown[]
      - unknown
    - `passes` Pass[]
      - `pass_id` string
      - `kind` 'scheduled' | 'adaptive' | 'monitor'
      - `scheduled` boolean
      - `started_at` string
      - `completed_at` string
      - `observed` integer
  - `pagination` Pagination, required
    - `limit` integer, required
    - `next_cursor` string, nullable, required
    - `total` integer, required

## Other responses

- `304`: Not modified. The If-None-Match value matched the current ETag.
- `400`: A parameter is invalid.
- `401`: The key is missing, invalid or revoked.
- `404`: Nothing with that id is available to this key.
- `429`: Rate limit reached. Retry-After says when to retry.

---

[API](https://skmtc.dev/broadcastwell/apis/broadcastwell-api.md) · [All operations](https://skmtc.dev/broadcastwell/apis/broadcastwell-api/llms.txt) · [OpenAPI document](https://skmtc.dev/broadcastwell/apis/broadcastwell-api/revisions/248819cafc35?raw)