---
title: "View templates"
method: GET
path: "/templates?app_id={app_id}&limit={limit}&offset={offset}"
---

# View templates

`GET /templates?app_id={app_id}&limit={limit}&offset={offset}`

## Request

- Base URL: `https://api.onesignal.com`
- URL: `https://api.onesignal.com/templates?app_id={app_id}&limit={limit}&offset={offset}`
- Auth: none required
- TypeScript: <https://skmtc.dev/onesignal/apis/api-onesignal-com/docs/templates%3Fapp_id=:app_id&limit=:limit&offset=:offset/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a paginated list of message templates from your OneSignal app. This endpoint returns summary information for each template, including ID, name, creation, and update timestamps.

## Query parameters

- `app_id` string, required
- `limit` integer
- `offset` integer
- `channel` 'push' | 'email' | 'sms'
- `name` string

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Response `200`

200

- object
  - `limit` integer
  - `offset` integer
  - `templates` object[]
    - `id` string: The ID of the template in UUID v4 format.
    - `name` string: An internal name you set to help organize and track Templates. Maximum 128 characters.
    - `created_at` string: The date and time the template was created in ISO 8601 format.
    - `updated_at` string: The date and time the template was last updated in ISO 8601 format.
  - `total_count` integer

## Other responses

- `400`: 400
- `429`: 429
- `503`: Service temporarily unavailable. Retry after a short backoff. The body may be empty or non-JSON in some failure modes.

## Changes

- **2026-11-09** `da1fb8954731`: 1 info
  - added the new optional `query` request parameter `name`

[Operation history](https://skmtc.dev/onesignal/apis/api-onesignal-com/changes/templates%3Fapp_id=:app_id&limit=:limit&offset=:offset/get.md)

---

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