---
title: "List generation jobs"
method: GET
path: "/generations"
---

# List generation jobs

`GET /generations`

## Request

- Base URL: `https://cactuscompute.com/v1`
- URL: `https://cactuscompute.com/v1/generations`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `after` string

## Response `200`

Jobs

- object
  - `object` 'list', required
  - `data` Job[], required
    - `id` string, required
    - `object` 'fine_tuning.job' | 'generation', required
    - `name` string, nullable
    - `deleted` boolean
    - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled', required
    - `created_at` integer, required: Unix seconds
    - `started_at` integer, nullable: Unix seconds
    - `finished_at` integer, nullable: Unix seconds
    - `elapsed_seconds` integer, nullable
    - `cancellation_requested` boolean
    - `error` object, nullable
      - `code` 'invalid_input' | 'execution_failed' | 'deadline_exceeded' | 'subscription_required' | 'insufficient_storage' | 'output_incomplete'
    - `model` 'needle-3': Fine-tunes only
    - `max_depth` integer: Fine-tunes only
    - `completed_steps` integer: Fine-tunes only, 0 to 5
    - `total_steps` integer: Fine-tunes only, always 5
    - `evaluations` object[]: Fine-tunes only; empty until status is succeeded, then one entry per depth from 2 to max_depth
      - `depth` integer, required
      - `validation` object, required
        - `correct` integer, required
        - `total` integer, required
        - `excluded` integer, required: Examples with no tools defined, left out of the score
      - `test` object, required
        - `correct` integer, required
        - `total` integer, required
        - `excluded` integer, required: Examples with no tools defined, left out of the score
    - `fine_tuned_model` string, nullable: Fine-tunes only; the full-depth model once succeeded
    - `files` JobFile[]: On retrieve only. Fine-tunes: the submitted inputs. Generations: the files it published (empty until succeeded)
      - `id` string, required
      - `filename` string, required
      - `group` 'train' | 'validation' | 'test' | 'unknown', required
      - `ordinal` integer, required
  - `has_more` boolean, required
  - `first_id` string
  - `last_id` string

## Other responses

- `4XX`: The request was rejected; `code` says why and `url` (when present) is the console page that clears it

---

[API](https://skmtc.dev/cactuscompute/apis/needle-fine-tuning-api.md) - [All operations](https://skmtc.dev/cactuscompute/apis/needle-fine-tuning-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cactuscompute/apis/needle-fine-tuning-api/revisions/227acc9b45e8?raw)