---
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}`

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'

## 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.

---

[API](https://skmtc.net/onesignal/apis/api-onesignal-com.md) · [All operations](https://skmtc.net/onesignal/apis/api-onesignal-com/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onesignal/api-onesignal-com/revisions/0fc223f7e338/schema)