---
title: "Read Test Run"
method: GET
path: "/api/v1/test-runs/{run_id}"
tags: ["engineering tests"]
---

# Read Test Run

`GET /api/v1/test-runs/{run_id}`

## 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/{run_id}`
- Auth: HTTP bearer

## Path parameters

- `run_id` string, uuid, required

## Response `200`

Successful Response

- EngineeringTestRunDetailResponse
  - `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
  - `raw_output` EngineeringSuiteOutputV1, required
    - `encoding` 'utf-8', required
    - `truncated` boolean, required
    - `bytes_total` integer, required
    - `sha256` string, required
    - `text` string, 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)