---
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

## Headers

- `Api-Key` 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.
  - `failure_reason` string — A short machine-readable reason the generation failed, for example `content_policy_violation`. Present only when `status` is `failed`.

## Other responses

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

---

[API](https://skmtc.net/ideogram/apis/api-reference.md) · [All operations](https://skmtc.net/ideogram/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ideogram/api-reference/versions/f6a8c81158c0/schema)