> ## Documentation Index > Fetch the complete documentation index at: https://docs.thanks.io/llms.txt > Use this file to discover all available pages before exploring further. # List Creatives > 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. ## OpenAPI ````yaml get /creatives/ openapi: 3.1.0 info: title: thanks.io API description: >- Use the thanks.io API to send postcards, letters, notecards, windowless letters, and gift cards. contact: url: https://thanks.io email: support@thanks.io version: 1.0.0 servers: - url: https://api.thanks.io/api/v2 description: The main API server for thanks.io security: - bearerAuth: [] tags: - name: Recipients - name: Mailing Lists - name: Send Mailer - name: Order Estimates - name: Orders - name: Message Templates - name: Image Templates - name: Creatives Library description: >- Your Creatives library: saved pairings of an image template and a message template. Sending one by `creative_id` is the recommended way to send. Creatives are designed in your dashboard; these endpoints list and read them so your integration can find the right `creative_id`. - name: Handwriting Styles - name: Giftcards - name: Dynamic Images description: '' - name: Image Builder - name: Sub Accounts - name: Webhooks - name: Webhook Events externalDocs: description: Learn more about thanks.io url: https://docs.thanks.io paths: /creatives/: get: tags: - Creatives Library summary: List All description: >- 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. operationId: getCreatives parameters: - $ref: '#/components/parameters/sub_account_id' - name: mailer_type in: query schema: type: string enum: - postcard - postcard6x9 - postcard6x11 - letter - windowlessletter - notecard - giftcard - magnacard description: >- Only return creatives of this type. `postcard` is 4x6. Use the type you will send: a 6x9 postcard send takes a `postcard6x9` creative. - name: complete_only in: query schema: type: boolean description: >- Only return creatives with both sides present (letters need only a message). Only complete creatives can be sent. Pass `1` to turn the filter on. - name: search in: query schema: type: string description: Only return creatives whose name contains this text. - name: include_hidden in: query schema: type: boolean description: Include creatives hidden from the library. Pass `1` to turn it on. - name: page in: query schema: type: integer description: Page number. responses: '200': description: OK content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/creative' links: $ref: '#/components/schemas/links' meta: $ref: '#/components/schemas/meta' example: data: - id: 501 name: Spring open house mailer_type: postcard postcard_size: 4x6 sub_account_id: null source: user hidden: false default: true preview_image_url: null thumbnail_url: https://cdn.thanks.io/creative-thumbnails/501.png share_url: >- https://dashboard.thanks.io/creatives/share/6f1c2e9a-8a7d-4b8e-9d37-1c2b3a4d5e6f is_complete: true needs: [] image_template: id: 6 name: Spring open house type: postcard image: >- https://s3.amazonaws.com/cdn.thanks.io/user_image_library/1533645532.png is_dynamic: false dynamic_image_url: null canva_id: null default: false created_from_creative_generation_id: null deleted: false message_template: id: 12 name: Spring open house type: postcard content: Hi %FIRST_NAME%, spring is here! handwriting_style_id: 7 custom_background_url: null skip_creative_generation: false default: false deleted: false back_background: null created_at: '2026-09-27T00:00:00.000000Z' updated_at: '2026-10-01T00:00:00.000000Z' links: first: https://api.thanks.io/api/v2/creatives?page=1 last: https://api.thanks.io/api/v2/creatives?page=1 prev: null next: null meta: current_page: 1 from: 1 last_page: 1 path: https://api.thanks.io/api/v2/creatives per_page: 24 to: 1 total: 1 '403': $ref: '#/components/responses/Unauthorized' components: parameters: sub_account_id: name: sub_account_id in: query description: Filter results by Sub Account ID. required: false schema: type: integer example: 1 schemas: creative: type: object description: >- 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. properties: id: type: integer description: Pass this as `creative_id` to send the creative. name: type: string mailer_type: type: - string - 'null' description: The type the creative sends as. `postcard` is 4x6. postcard_size: type: - string - 'null' sub_account_id: type: - integer - 'null' source: type: - string - 'null' hidden: type: boolean default: type: boolean preview_image_url: type: - string - 'null' thumbnail_url: type: - string - 'null' share_url: type: - string - 'null' is_complete: type: boolean description: >- Whether the creative can be sent: both sides present and not deleted (letters need only a message). needs: type: array items: type: string enum: - front - message description: The sides an incomplete creative is missing. image_template: type: - object - 'null' description: >- The front. `deleted` is true when the template was deleted after the creative was made. message_template: type: - object - 'null' description: >- The message. `deleted` is true when the template was deleted after the creative was made. back_background: type: - object - 'null' created_at: type: string updated_at: type: string links: type: object properties: first: type: - string - 'null' description: URL of the first page of results last: type: - string - 'null' description: URL of the last page of results prev: type: - string - 'null' description: URL of the previous page of results next: type: - string - 'null' description: URL of the next page of results meta: type: object properties: current_page: type: integer example: 1 description: Current page number from: type: - integer - 'null' example: 1 description: Index of the first item on the current page last_page: type: integer example: 1 description: Total number of pages path: type: string description: Base URL for the resource per_page: type: integer example: 25 description: Number of items per page to: type: - integer - 'null' example: 1 description: Index of the last item on the current page total: type: integer example: 1 description: Total number of items responses: Unauthorized: description: Access token is missing or invalid content: application/json: schema: type: object properties: message: type: string example: Unauthorized securitySchemes: bearerAuth: type: http scheme: bearer description: Bearer token authentication using your thanks.io API key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.