---
title: "List All"
method: GET
path: "/creatives/"
tags: ["Creatives Library"]
---

# List All

`GET /creatives/`

## Request

- Base URL: `https://api.thanks.io/api/v2`
- URL: `https://api.thanks.io/api/v2/creatives/`
- Auth: HTTP bearer

List the creatives in your Creatives library, 24 per page: the default creative of each type first, then most recently updated. A creative pairs an image template with a message template; send one by passing its `id` as `creative_id` to any send or estimate endpoint.

## Query parameters

- `sub_account_id` integer
- `mailer_type` 'postcard' | 'postcard6x9' | 'postcard6x11' | 'letter' | 'windowlessletter' | 'notecard' | 'giftcard' | 'magnacard'
- `complete_only` boolean
- `search` string
- `include_hidden` boolean
- `page` integer

## Response `200`

OK

- object
  - `data` Creative[]
    - `id` integer: Pass this as `creative_id` to send the creative.
    - `name` string
    - `mailer_type` string, nullable: The type the creative sends as. `postcard` is 4x6.
    - `postcard_size` string, nullable
    - `sub_account_id` integer, nullable
    - `source` string, nullable
    - `hidden` boolean
    - `default` boolean
    - `preview_image_url` string, nullable
    - `thumbnail_url` string, nullable
    - `share_url` string, nullable
    - `is_complete` boolean: Whether the creative can be sent: both sides present and not deleted (letters need only a message).
    - `needs` string[]: The sides an incomplete creative is missing.
    - `image_template` object, nullable: The front. `deleted` is true when the template was deleted after the creative was made. `tracked_qr_url` is set when the front prints a tracked thanks.io QR code over the one in your uploaded design, and is the address its scans go to.
    - `message_template` object, nullable: The message. `deleted` is true when the template was deleted after the creative was made.
    - `back_background` object, nullable
    - `created_at` string
    - `updated_at` string
  - `links` Links
    - `first` string, nullable: URL of the first page of results
    - `last` string, nullable: URL of the last page of results
    - `prev` string, nullable: URL of the previous page of results
    - `next` string, nullable: URL of the next page of results
  - `meta` Meta
    - `current_page` integer: Current page number
    - `from` integer, nullable: Index of the first item on the current page
    - `last_page` integer: Total number of pages
    - `path` string: Base URL for the resource
    - `per_page` integer: Number of items per page
    - `to` integer, nullable: Index of the last item on the current page
    - `total` integer: Total number of items

## Other responses

- `403`: Access token is missing or invalid

## Changes

- **2026-10-09** `9b6aa91faff7`: 1 info
  - endpoint added
- **2026-10-09** `c76fc453c7ca`: 1 breaking
  - api path removed without deprecation
- **2026-10-07** `aaf5a075a328`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/thanks-io/apis/thanks-io-api/changes/creatives/get.md)

---

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