---
title: "Read Test Runs"
method: GET
path: "/api/v1/test-runs"
tags: ["engineering tests"]
---

# Read Test Runs

`GET /api/v1/test-runs`

## Request

- Base URL: `https://api.brumby.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brumby.com/api/v1/test-runs`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `before` string, nullable
- `suite` string, nullable
- `status` 'passed' | 'failed' | 'error': Terminal status of one completed engineering-suite execution.
- `result_status` 'passed' | 'failed' | 'skipped' | 'error' | 'not_run': Terminal or explicitly unexecuted status of one catalogue scenario.
- `device_id` string, nullable
- `platform` string, nullable
- `domain` string, nullable
- `component` string, nullable
- `mechanism` string, nullable
- `kind` string, nullable
- `scenario_id` string, nullable

## Response `200`

Successful Response

- EngineeringTestRunFeedResponse
  - `items` EngineeringTestRunSummaryResponse[], required
    - `run_id` string, uuid, required
    - `schema_version` '1', required
    - `suite` string, required
    - `device_id` string, nullable, required
    - `status` 'passed' | 'failed' | 'error', required: Terminal status of one completed engineering-suite execution.
    - `started_at` string, date-time, required
    - `finished_at` string, date-time, required
    - `duration_ms` integer, required
    - `imported_at` string, date-time, required
    - `imported_by_actor` string, required
    - `manifest_sha256` string, required
    - `catalogue_version` integer, required
    - `catalogue_sha256` string, required
    - `source` EngineeringTestSourceV1, required
      - `repository` string, required
      - `commit_sha` string, required
      - `tree_sha` string, required
      - `branch` string, nullable
      - `dirty` boolean, required
    - `runner` EngineeringTestRunnerV1, required
      - `hostname` string, required
      - `platform` string, required
      - `architecture` string, required
      - `python_version` string, required
      - `producer_version` string, required
    - `command` string[], required
    - `exit_code` integer, nullable, required
    - `counts` EngineeringTestCountsV1, required
      - `total` integer, required
      - `passed` integer, required
      - `failed` integer, required
      - `skipped` integer, required
      - `error` integer, required
      - `not_run` integer, required
      - `checks` integer, required
      - `failures` integer, required
    - `scenario_count` integer, required
  - `next_cursor` string, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/brumby/apis/brumby-platform-api.md) - [All operations](https://skmtc.dev/brumby/apis/brumby-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/brumby/apis/brumby-platform-api/revisions/fe185e20813e?raw)