---
title: "Get"
method: GET
path: "/creatives/{creativeId}"
tags: ["Creatives Library"]
---

# Get

`GET /creatives/{creativeId}`

## Request

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

Get one creative from your Creatives library, with the image and message templates it pairs.

## Path parameters

- `creativeId` integer, required

## Response `200`

OK

- object
  - `data` Creative: A creative from your Creatives library: a saved pairing of an image template and a message template, sent exactly as saved by passing its `id` as `creative_id` to any send or estimate endpoint.
    - `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

## Other responses

- `403`: Access token is missing or invalid
- `404`: Resource not found

## Changes

- **2026-10-12** `f1628cec25d0`: 1 info
  - added the non-success response with the status `404`
- **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/:creativeId/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)