---
title: "List templates for a WhatsApp account"
method: GET
path: "/whatsapp/{account_uuid}/templates"
tags: ["whatsapp"]
---

# List templates for a WhatsApp account

`GET /whatsapp/{account_uuid}/templates`

## Request

- Base URL: `https://public-api.ringover.com/v2`
- URL: `https://public-api.ringover.com/v2/whatsapp/{account_uuid}/templates`
- Auth: API key in header `Authorization`

Retrieves all WhatsApp message templates associated with the specified account.

**Permission:** Access is managed by the WhatsApp service. No specific API token permission is checked.

**Monitoring:** No impact.

## Path parameters

- `account_uuid` string, uuid, required

## Response `200`

Successful operation — returns the list of templates for the account.

- object[]
  - `account_uuid` string, uuid
  - `content` string
  - `creation_date` string, date-time
  - `status` string
  - `template_uuid` string, uuid
  - `title` string
  - `components` WhatsappTemplateComponent[]
    - `type` 'HEADER' | 'BODY' | 'FOOTER' | 'BUTTONS'
    - `format` string
    - `value` string
    - `buttons` object[]
      - `type` 'QUICK_REPLY' | 'URL' | 'PHONE_NUMBER'
      - `text` string
      - `url` string
      - `phone_number` string
    - `variables` WhatsappTemplateVariable[]
      - `variable_label` string, required: Placeholder label, matching the `{{label}}` used in the component text. Any name made of letters, digits and underscores is accepted, not just numbers.
      - `example_value` string: Sample value shown to Meta for template review. Defaults to `sample` when omitted.

## Other responses

- `401`: Unauthorized — access denied by the WhatsApp service.
- `404`: Not found — the specified account does not exist.
- `500`: Internal server error.

## Changes

- **2026-10-01** `5b3e0427c522`: 1 info
  - added the optional property `items/components` to the response with the `200` status
- **2026-08-25** `241a8d30fa9b`: 1 breaking
  - for the `path` request parameter `account_uuid`, the format changed from no format to `uuid`
- **2025-11-20** `d92d55716cc3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ringover/apis/ringover-public-api/changes/whatsapp/:account_uuid/templates/get.md)

---

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