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

# List generations

`GET /api/v2/generations`

## Request

- Base URL: `https://azurade.com`
- URL: `https://azurade.com/api/v2/generations`
- Auth: one of:
  - HTTP bearer
  - API key in header `Authorization`

Your generations, newest first, optionally only one status, model or type. Page with next_cursor. An unknown filter value answers 400 invalid_query.

## Query parameters

- `limit` integer
- `cursor` string
- `status` 'pending' | 'completed' | 'failed' | 'stalled' | 'canceled'
- `model` string
- `type` 'image' | 'video'

## Response `200`

OK

- GenerationList
  - `generations` Generation[]
    - `cost` number: Credits the generation costs: taken when it was accepted, less the share of any images it was asked for and did not deliver, which is refunded
    - `created` string, date-time
    - `error` string: Why it failed, when it did
    - `id` string
    - `input` object: The request body as submitted
    - `model` string
    - `outputs` Output[]
      - `content_type` string
      - `filename` string
      - `id` string
      - `poster_url` string, uri: First frame of a video output as JPEG, an unguessable link like url; absent for images
      - `url` string, uri: Unguessable link that downloads without authentication; anyone holding it can fetch the file
    - `prompt_used` string: The prompt the model was given, when translate_prompt or enhance_prompt rewrote the one in input
    - `status` 'pending' | 'completed' | 'failed' | 'stalled' | 'canceled'
    - `type` 'image' | 'video'
    - `updated` string, date-time
  - `next_cursor` string: Opaque; pass it unchanged as cursor to fetch the next page. Absent on the last page

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid credentials

---

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