---
title: "Look up a content template"
method: GET
path: "/api/content/templates/{template_id}"
tags: ["Content"]
---

# Look up a content template

`GET /api/content/templates/{template_id}`

## Request

- Base URL: `https://go.urbanairship.com`
- URL: `https://go.urbanairship.com/api/content/templates/{template_id}`
- 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/:template_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Fetch a single content template using UUID.

## Response `200`

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

- object
  - `content_template` ContentTemplateObject: A reusable template containing fields for a message type. Can be referenced by its UUID or a customer-defined external ID.
    - `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.
  - `ok` boolean, required: If `true`, the operation completed successfully and returns an expected response.

## Other responses

- `401`: Authentication information (the app key and secret or bearer token) was either incorrect or missing.
- `404`: The requested resource doesn't exist.

## 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/:template_id/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)