---
title: "List content templates"
method: GET
path: "/api/content/templates"
tags: ["Content"]
---

# List content templates

`GET /api/content/templates`

## Request

- Base URL: `https://go.urbanairship.com`
- URL: `https://go.urbanairship.com/api/content/templates`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Client credentials
    - Token URL: `http://oauth2.{domain}.com/token` scopes: `tpl`
- TypeScript: <https://skmtc.dev/airship/apis/airship-api/docs/api/content/templates/get.ts> (a function with typed inputs; its response is checked against the schema)

List all existing content templates. Returns an array of content template objects in the `content_templates` attribute.

## Query parameters

- `page` integer
- `page_size` integer
- `sort` 'created_at' | 'modified_at'
- `order` 'asc' | 'desc'

## Response `200`

Returned on success, with the JSON representation of the content templates in the body of the response.

- object
  - `content_templates` ContentTemplateObject[]: An array of content template objects.
    - `content` union, required: The content of the given type, using the associated model object below.
      - EmailTemplatesObject: The email-specific fields for a template.
        - `html_body` string, required: The HTML content of the email.
        - `plaintext_body` string, required: The plaintext content of the email.
        - `subject` string, required: The email subject.
      - SmsTemplatesObject: The SMS-specific fields for a template.
        - `alert` string, required: The SMS content.
      - OpenChannelTemplatesObject: The open channel-specific fields for a template.
        - `alert` string, required: The text that will display in your open channel message.
        - `media_attachment` string: The URL for media you want to include in your message.
        - `summary` string: Supplemental text displayed with the notification.
        - `title` string: A heading that appears above the notification text when applicable.
      - AppAndWebTemplatesObject: The app and web push fields for a template.
        - `alert` string, required: The text that will display in your push notification.
        - `icon` string: A string representing a URL or an image file included in the application's resources.
        - `summary` string: Supplemental text displayed with the notification.
        - `title` string: A heading that appears above the notification text when applicable.
      - MessageCenterTemplatesObject: The Message Center-specific fields for a template.
        - `html_body` string, required: The body of the message. This can be a full HTML message.
        - `title` string: A heading that appears above the message and in the Message Center inbox.
    - `created_at` string, date-time: The [date-time](#date-time-format) when this template was created.
    - `description` string: The description of the template.
    - `external_id` string: An optional ID for referencing this template in future API calls. Must be unique within your project.
    - `feed_references` FeedReferences: An object used to indicate that an external data feed should be invoked, the name of the feed to invoke, and the way in which to invoke it. You can only include a feed if you include a `templates` object in the payload or set the `personalization` option to `true`.
      - `defaults` object: Default parameter values for your feed. These values override any defaults you set for your feed in the Airship dashboard.
      - `feeds` object[], required: An array of feeds that you want to use to personalize your message.
        - `name` string, required: The feed ID set in the dashboard.
        - `on_error` 'continue' | 'cancel': Determines how the message is handled if the feed is unreachable or does not return an expected response. Defaults to `cancel`.
        - `params` object: An optional dictionary of overrides for default parameters in handlebars referencing the feed.
    - `id` string, uuid: The unique ID assigned to the template. Used to retrieve or reference the template in other endpoints.
    - `modified_at` string, date-time: The [date-time](#date-time-format) when this template was last modified.
    - `name` string, required: The human-readable name of the template.
    - `snippet_references` SnippetReferences: An object used to indicate that a set of snippets should be loaded for use in message content. Use the following syntax in your payload: `{{> your_snippet_name }}` to reference the snippet content within a notification or rich message. See [Snippets](/guides/personalization/content/snippets/) to see how to create a snippet in the Airship dashboard.
      - `snippets` object[], required: An array of snippets that you want to use to personalize your message.
        - `name` string, required: The name of the snippet that you set up in the Airship dashboard.
    - `type` 'email' | 'sms' | 'open' | 'app' | 'web' | 'message_center', required: The type of message.
  - `count` integer: The number of content templates in the current response. This is effectively the page size.
  - `next_page` string, url: There might be more than one page of results for this listing. When present, use this URL to fetch the next batch of results.
  - `ok` boolean, required: Success.
  - `prev_page` string, url: Link to the previous page, if available.
  - `total_count` integer: The total number of content templates.

## Other responses

- `401`: Authentication information (the app key and secret or bearer token) was either incorrect or missing.

## Changes

- **2026-06-24** `38241778b0c1`: 1 info
  - endpoint added
  - …this revision’s changelog is incomplete

[Operation history](https://skmtc.dev/airship/apis/airship-api/changes/api/content/templates/get.md)

---

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