---
title: "List Image Generations"
method: GET
path: "/v1/flows/image"
tags: ["Flows", "Image"]
---

# List Image Generations

`GET /v1/flows/image`

List the image generations created through this API, newest first.

## Query parameters

- `cursor` string, nullable — Pagination cursor: the `next_cursor` value of the previous page's response. Omit it for the first page.
- `page_size` integer — How many generations to return per page.
- `status` 'pending' | 'generating' | 'completed' | 'failed', nullable — Only return generations with this lifecycle status.
- `model_id` string, nullable — Only return generations of this model.

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- MediaGenerationListResponse — One page of the caller's generations, newest first.
  - `generations` MediaGenerationResponse[], required — The generations on this page, newest first. Each item has the same shape as the corresponding GET endpoint's response.
    - union
      - MediaGenerationInProgressResponse — A media generation that has not finished yet.
        - `id` string, required — The unique identifier of the generation.
        - `status` 'pending' | 'generating', required — The lifecycle status of the generation. It ends at `completed` or `failed`.
      - MediaGenerationCompletedResponse — A completed media generation and its output.
        - `id` string, required — The unique identifier of the generation.
        - `status` 'completed', required — The lifecycle status of the generation.
        - `content_url` string, required — A signed URL to download the generated media from. It expires about an hour after this response is returned; fetch the generation again for a fresh URL.
        - `content_mime_type` string, required — The MIME type of the generated media.
      - MediaGenerationFailedResponse — A failed media generation and why it failed.
        - `id` string, required — The unique identifier of the generation.
        - `status` 'failed', required — The lifecycle status of the generation.
        - `failure_reason` 'timeout' | 'model_error' | 'moderated' | 'invalid_parameters' | 'dependency_failed' | 'charging_failed' | 'internal_error', required — The category of failure.
        - `error_message` string, required — A human-readable description of the failure. Failed generations are not charged.
  - `next_cursor` string, nullable, required — Pass as `cursor` to fetch the next page. `null` when there is no further page.
  - `has_more` boolean, required — Whether more generations exist beyond this page.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/revisions/acb0175c0525/schema)