---
title: "Get Run"
method: GET
path: "/v1/runs/{run_id}"
---

# Get Run

`GET /v1/runs/{run_id}`

## Request

- Base URL: `https://api.cybret.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cybret.ai/v1/runs/{run_id}`
- Auth: HTTP bearer

## Path parameters

- `run_id` string, required

## Response `200`

Successful Response

- RunRecord
  - `agent_identities` RunAgentIdentity[]: Ephemeral signup identities minted for this run. Omitted when the run minted none. Each item is only an opaque identity_ref, its lifecycle status, and the fixed reason code of its latest failure.
    - `identity_ref` string, required
    - `status` 'claiming' | 'verified' | 'bound' | 'teardown' | 'failed', required
    - `reason_code` 'signup_endpoint_not_discovered' | 'signup_rejected' | 'signup_request_failed' | 'mailbox_verification_timed_out' | 'no_session' | 'signup_blocked_by_challenge' | 'hosted_idp_not_opted_in' | 'hosted_idp_form_unrecognized' | 'hosted_idp_signup_unavailable' | 'mailbox_provider_unavailable': Fixed, secret-free reasons a mint did not bind a session.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Unprocessable Entity
- `425`: Too Early
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/cybret/apis/api-scanner-control-plane.md) · [All operations](https://skmtc.dev/cybret/apis/api-scanner-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/cybret/apis/api-scanner-control-plane/revisions/4c9b522246af?raw)