---
title: "/creatives/generations/{generation_id}"
method: GET
path: "/projects/{project_id}/creatives/generations/{generation_id}"
tags: ["Creatives"]
---

# /creatives/generations/{generation_id}

`GET /projects/{project_id}/creatives/generations/{generation_id}`

## Request

- Base URL: `https://api.productbyte.com/v1`
- URL: `https://api.productbyte.com/v1/projects/{project_id}/creatives/generations/{generation_id}`
- Auth: HTTP bearer

Reports on a generation started by `/creatives/generate`.

Poll until `status` stops being `running`; on `succeeded`, read the creative at `creative_id` for its formats. There is no progress percentage — the pipeline has no meaningful one to give.

Requires the `creatives:read` scope.

## Path parameters

- `project_id` string, required: The project the generation belongs to.
- `generation_id` string, required: The generation to read.

## Response `200`

The generation.

- object
  - `id` string, required: Pass this to `/creatives/generations/{generation_id}` to follow it.
  - `creative_id` string, required: The creative being generated into. It exists from the moment the generation starts, empty until the first result lands, so you can reference it before the work finishes.
  - `status` 'running' | 'succeeded' | 'failed', required: `running` until it settles. On `succeeded`, read the creative for its formats.
  - `error_code` string: Why it failed. A stable code, never prose.
  - `created_at` string, date-time, required: When the generation was started.
  - `updated_at` string, date-time, required: When it last changed.

## Other responses

- `401`: Missing, unknown, revoked, or expired key (`API_KEY_UNAUTHORIZED`).
- `403`: The key lacks `creatives:read`, or the project is outside its allowlist.
- `404`: No such generation in this project (`API_GENERATION_NOT_FOUND`).
- `429`: Too many requests for this key (`API_RATE_LIMITED`). Back off and retry; `Retry-After` gives the window length.

---

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