---
title: "Poll a generation"
method: GET
path: "/v1/generations/{generation_id}"
tags: ["generate"]
---

# Poll a generation

`GET /v1/generations/{generation_id}`

Retrieves the current status of an asynchronous generation, and its results once complete. Use the `generation_id` returned by the async generation endpoint. While the generation is `pending` or has `failed`, the response contains only `generation_id`, `status`, and `created`; the `response_type` and `data` fields are present only once `status` is `completed`.

## Path parameters

- `generation_id` string, required

## Response `200`

Generation status retrieved successfully.

- GenerationResponse — The current status and, when complete, result data for an asynchronous generation.
  - `generation_id` string, required — URL-safe base64 ID of the generation.
  - `status` 'pending' | 'completed' | 'failed', required — Current status of the generation. `pending`: still in progress; the response contains only `generation_id`, `status`, and `created`. `completed`: finished successfully; the response also includes `response_type` and `data`. `failed`: generation did not succeed; the response contains only `generation_id`, `status`, and `created`.
  - `created` string, date-time, required — The time the generation was created.
  - `response_type` 'url' — Present when `status` is `completed`; always "url" for this shape.
  - `data` ImageGenerationObject[] — A list of generated images. Present when `status` is `completed`.
    - `url` string, uri, nullable — The direct link to the image generated.
    - `prompt` string, required — The prompt used for the generation. This may be different from the original prompt.
    - `resolution` string, required — The resolution of the generated image, formatted as "{width}x{height}".
    - `is_image_safe` boolean, required — Whether this image passes safety checks. If false, the url field will be empty.
    - `seed` integer, required — Random seed. Set for reproducible generation.

## Other responses

- `400` — Invalid request ID provided.
- `401` — Not authorized.
- `404` — Request not found.
- `429` — Too many requests.

---

[API](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0.md) · [All operations](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ideogram/ideogram-openapi-3-0/revisions/2e00e5d8d50d/schema)