---
title: "List runs"
method: GET
path: "/api/runs"
---

# List runs

`GET /api/runs`

## Request

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

List your automation runs, most recent first.

## Query parameters

- `page` integer
- `pageSize` integer
- `status` 'cancelled' | 'error' | 'queued' | 'running' | 'success'
- `script_id` string, uuid
- `host` string

## Response `200`

OK

- PaginatedResponseRun
  - `data` Run[], required
    - `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
  - `hasNextPage` boolean, required
  - `totalCount` number

## Other responses

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

---

[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)