---
title: "Read a run and its evidence"
method: GET
path: "/v1/runs/{run}"
---

# Read a run and its evidence

`GET /v1/runs/{run}`

## Request

- Base URL: `https://api.proxymail.qa`
- URL: `https://api.proxymail.qa/v1/runs/{run}`
- Auth: HTTP bearer

As JSON, or with `format=markdown` the report for a pull request comment or a job summary. Both compare it with the last 10 finished runs of the same name (`comparison` in JSON: how many runs, and a list of changes, each a `kind` and its `text` in parts).

## Path parameters

- `run` string, uuid, required

## Query parameters

- `format` 'json' | 'markdown'

## Response `200`

The run

- Run
  - `id` string, uuid
  - `name` string
  - `source` 'ci' | 'agent' | 'api'
  - `status` 'running' | 'passed' | 'failed'
  - `meta` object
  - `started_at` string, date-time
  - `finished_at` string, date-time, nullable
  - `url` string, uri: The run in the app.
  - `project` object
    - `id` string
    - `name` string
  - `events` object[]: What the run saw, oldest first. Not in lists.
    - `at` string, date-time
    - `kind` 'address' | 'email' | 'missing' | 'none' | 'count' | 'checks' | 'note' | 'checkout'
    - `address` string, nullable
    - `failed` boolean
    - `detail` object: email: type, subtype, service, received_at, after_seconds, and code or link and goes_to ({ site, path }). missing: what was waited for and hint. none: arrived, since, until. count: count. checks: passed, failed, warnings and notes. note: text.

## Other responses

- `404`: An error

---

[API](https://skmtc.dev/proxymail/apis/proxy-mail-qa-api.md) · [All operations](https://skmtc.dev/proxymail/apis/proxy-mail-qa-api/llms.txt) · [OpenAPI document](https://skmtc.dev/proxymail/apis/proxy-mail-qa-api/revisions/8f8a5e84cf5c?raw)