---
title: "List All"
method: GET
path: "/message-templates/"
tags: ["Message Templates"]
---

# List All

`GET /message-templates/`

## Request

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

List all available message templates.

## Query parameters

- `items_per_page` integer
- `sub_account_id` integer
- `type` 'postcard' | 'postcard6x9' | 'postcard6x11' | 'letter' | 'windowlessletter' | 'notecard' | 'giftcard' | 'magnacard'

## Response `200`

OK

- object
  - `data` MessageTemplate[]
    - `id` integer
    - `user_id` integer
    - `sub_account_id` integer, nullable
    - `handwriting_style_id` integer: ID of the handwriting style used in the message template
    - `font_size` integer: Font size used in the message template. Only valid for AI fonts
    - `font_color` string: Font color used in the message template.
    - `handwriting_realism` boolean: Handwriting realism level used in the message template. Only valid for AI fonts
    - `name` string
    - `content` string
    - `additional_pages` string, uri: URL to additional pages to include with the cover letter. Only valid for letter templates.
    - `skip_creative_generation` integer: Flag to skip creative generation. Set when message template is PDF file only.
    - `custom_background_url` string: URL of the custom background image for the message template. Only valid for postcard backs and the interior background of notecards and giftcards.
    - `qrcode_url` string: URL of the QR code image for the message template
    - `cc_emails` string[]: List of email addresses to be CC'd on when a QR code is scanned
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `type` 'postcard' | 'postcard6x9' | 'postcard6x11' | 'letter' | 'windowlessletter' | 'notecard' | 'giftcard' | 'magnacard': Type of the message template
    - `giftcard_brand_code` string: Brand code of the gift card
    - `giftcard_brand_image` string: Image URL of the gift card brand
    - `giftcard_amount` integer: Amount of the gift card in cents
    - `landing_page_url` string, uri: URL of the gated landing page (also known as a gating URL). Recipients must visit this page before they can redeem the gift card, letting you gate redemption behind an action such as booking a demo or completing a form. Only valid for giftcards.
    - `share_uuid` 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-01** `02de08ab2a47`: 1 warning, 1 info
  - added the new `postcard6x9` enum value to the `data/items/type` response property for the response status `200`
  - added the new optional `query` request parameter `type`
- **2026-08-05** `670a67b234a2`: 3 warning, 1 info
  - removed the optional property `data/items/realism` from the response with the `200` status
  - added the new `magnacard` enum value to the `data/items/type` response property for the response status `200`
  - added the new `postcard6x11` enum value to the `data/items/type` response property for the response status `200`
  - added the optional property `data/items/handwriting_realism` to the response with the `200` status
- **2025-09-10** `94e89686cb6b`: 1 info
  - added the new optional `query` request parameter `sub_account_id`
- **2025-09-10** `92b491bc255d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/thanks-io/apis/thanks-io-api/changes/message-templates/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)