---
title: "List recent jobs"
method: GET
path: "/jobs"
---

# List recent jobs

`GET /jobs`

## Request

- Base URL: `https://api.openmayhem.ai/v1`
- URL: `https://api.openmayhem.ai/v1/jobs`
- Auth: HTTP bearer

## Response `200`

Recent jobs for the account.

- object
  - `object` 'list', required
  - `data` Job[], required
    - `id` string
    - `status` 'submitted' | 'running' | 'reconciling' | 'completed' | 'failed' | 'cancelled'
    - `polling_url` string
    - `cost` string: USD, set once settled.
    - `retail_cost_limit` string, nullable: Effective per-request retail USD cap after combining request and API-key limits.
    - `routing` object: Validated routing controls frozen when the job was submitted.
    - `artifacts` object[]
      - `id` string
      - `content_type` string
      - `size_bytes` integer

## Other responses

- `401`: Missing or invalid API key.

---

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