---
title: "List generations"
method: GET
path: "/generations"
tags: ["Generations"]
---

# List generations

`GET /generations`

## Request

- Base URL: `https://api.cut.pro/api/v1`
- URL: `https://api.cut.pro/api/v1/generations`
- Auth: API key in header `X-Api-Key`

The workspace's images and videos generated with `POST /generations`, newest first.

## Query parameters

- `kind` 'image' | 'video'
- `page` number: Page number (default: 1)
- `limit` number: Items per page (default: 20, max: 100)

## Response `200`

Response for status 200

- object
  - `generations` object[], required
    - `id` string, required
    - `kind` 'image' | 'video', required
    - `status` 'processing' | 'ready' | 'failed', required: `processing` until it ends `ready` or `failed`; a failed one gives the credits back.
    - `model` string, required
    - `model_name` string, required
    - `mode` 'text' | 'image' | 'frames' | 'references', required: `text`: from the prompt alone. `image`: animates one image, the first frame (video only). `frames`: goes from a first to a last image (video only). `references`: borrows a person, product or style from the images, or edits them (image).
    - `resolution` string, nullable, required
    - `seconds` number, nullable, required
    - `aspect_ratio` '21:9' | '16:9' | '3:2' | '4:3' | '5:4' | '1:1' | '4:5' | '3:4' | '2:3' | '9:16', required
    - `prompt` string, nullable, required
    - `image_ids` string[], required
    - `credits_charged` number, required
    - `error_code` 'MEDIA_REJECTED' | 'COPYRIGHT_BLOCKED' | 'REAL_FACES_BLOCKED' | 'SAFETY_BLOCKED' | 'MEDIA_FAILED' | 'MEDIA_UNAVAILABLE' | 'INSUFFICIENT_CREDITS' | 'TIMEOUT' | 'OUTPUT_CHECK_FAILED', nullable, required
    - `edit_id` string, nullable, required: Set on a ready video: pass it to `POST /posts` to publish or schedule it.
    - `output` object, nullable, required: Set once `ready`, unless the file was deleted from the library.
      - `image_id` string, nullable, required: Set on an image: pass it in `image_ids` of `POST /generations` to animate or edit it.
      - `url` string, required: Signed preview link, valid for 6 hours.
      - `thumbnail_url` string, nullable, required
    - `expected_seconds` number, nullable, required: How long this model usually takes, while `processing`.
    - `created_at` string, required
  - `pagination` object, required
    - `current_page` number, required: Current page number (1-based)
    - `total_pages` number, required: Total number of pages
    - `total_count` number, required: Total number of items across all pages
    - `has_next_page` boolean, required
    - `has_previous_page` boolean, required
    - `limit` number, required: Items per page used for this response

---

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