---
title: "Get run"
method: GET
path: "/api/runs/{runId}"
---

# Get run

`GET /api/runs/{runId}`

## Request

- Base URL: `https://reduck.ai`
- URL: `https://reduck.ai/api/runs/{runId}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Fetch one of your runs by id.

## Path parameters

- `runId` string, uuid, required

## Response `200`

OK

- Run
  - `id` string, required
  - `user_id` string, required
  - `name` string, required
  - `browser` union, required
    - object
      - `type` 'managed', required
      - `region` string, required
      - `country` string, required
    - object
      - `type` 'extension', required
  - `args` object, required
  - `status` 'cancelled' | 'error' | 'queued' | 'running' | 'success', required
  - `result` union, required
    - object
      - `result` object, required
    - object
      - `error` string, required
  - `source` 'cli' | 'mcp' | 'rest', required
  - `started_at` string, required
  - `finished_at` string, nullable, required
  - `script` object, nullable, required
    - `id` string, required
    - `version_id` string, required
    - `version_number` string, required
    - `name` string, required
    - `handle` string, required
    - `slug` string, required
    - `host` string, required

## Other responses

- `401`: Not authenticated
- `403`: Forbidden
- `404`: Not found

---

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