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

# List generations

`GET /generations`

## Request

- Base URL: `https://www.rainbrand.com/api/v1`
- URL: `https://www.rainbrand.com/api/v1/generations`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://www.rainbrand.com/api/auth/oauth2/authorize`
    - Token URL: `https://www.rainbrand.com/api/auth/oauth2/token`

List your generations, newest first. Outputs that were later deleted stay listed with available set to false.

## Query parameters

- `brandSessionId` string, uuid: Only list generations for this brand.
- `type` 'image' | 'video' | 'audio' | 'svg': Only list generations of this type.
- `limit` integer: Results per page (1–100, default 50)
- `cursor` string: Pagination cursor from a previous response's nextCursor

## Response `200`

OK

- object
  - `data` object, required
    - `generations` object[], required
      - `id` string, uuid, required: Generation ID returned when the request started.
      - `status` 'pending' | 'generating' | 'completed' | 'failed', required: Current generation status.
      - `type` string, required: Requested output type. Known values: image, video, audio, svg; more may be added.
      - `model` string, required: Exact model ID returned by GET /models.
      - `brandSessionId` string, uuid, required: Brand the generation belongs to.
      - `outputs` object[], required: Output files in provider order. Empty until the generation completes.
        - `id` string, uuid
        - `type` string, required
        - `url` string, uri
        - `available` boolean, required
        - `mimeType` string, required
        - `durationMs` integer, nullable, required: File duration in milliseconds, when known. Null for images.
        - `width` integer, nullable, required: Displayed width in pixels, when known. Null for audio.
        - `height` integer, nullable, required: Displayed height in pixels, when known. Null for audio.
      - `failure` object, nullable, required: Failure details, or null when generation has not failed.
        - `code` 'upstream_failed', required
        - `message` string, required
        - `retryable` boolean, required: True when a new attempt with the same request may succeed; if you sent an Idempotency-Key, use a new key for it. False when the request must change first, or when a video may still be finishing and already billed.
        - `providerMessage` string, nullable, required: The provider's explanation of why it rejected the request, with links and secrets removed. Null when the provider gave none, or when the failure concerns Rainbrand's own account or a provider-side error. Its wording can change.
      - `createdAt` string, date-time, required: Time the generation was created.
    - `nextCursor` string, nullable, required
    - `hasMore` boolean, required

## Other responses

- `401`: 401
- `403`: 403
- `429`: 429

---

[API](https://skmtc.dev/rainbrand/apis/rainbrand-api.md) - [All operations](https://skmtc.dev/rainbrand/apis/rainbrand-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rainbrand/apis/rainbrand-api/revisions/012b8e9da4df?raw)