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

# /creatives

`GET /projects/{project_id}/creatives`

## Request

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

Lists the project’s creatives, newest first.

Entries carry `format_count` rather than the formats themselves; read a single creative to get the `format_ids` a post needs.

Paginate with `cursor`: pass the `next_cursor` from the previous page. It is absent on the last page.

Requires the `creatives:read` scope.

## Path parameters

- `project_id` string, required: The project to list creatives for.

## Query parameters

- `kind` 'image' | 'carousel' | 'video': Only creatives built from this kind of media.
- `query` string: Match against the creative name.
- `limit` integer: Page size, 1–100.
- `cursor` string: A `next_cursor` from a previous page.

## Response `200`

A page of creatives.

- object
  - `creatives` object[], required: Creatives, newest first.
    - `id` string, required: Pass this as `creative_id` when creating a post.
    - `name` string, required: The creative’s name.
    - `kind` 'image' | 'carousel' | 'video', required: What the creative is built from.
    - `format_count` integer, required: How many formats it holds. Read the creative to list them.
    - `created_at` string, date-time, required: When the creative was created.
    - `updated_at` string, date-time, required: When it last changed.
  - `next_cursor` string: Pass as `cursor` to fetch the next page. Absent when there are no more.

## 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.
- `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)