---
title: "List WhatsApp templates"
method: GET
path: "/v1/whatsapp/senders/{number}/templates"
tags: ["WhatsApp"]
---

# List WhatsApp templates

`GET /v1/whatsapp/senders/{number}/templates`

Returns the WhatsApp templates registered for the sender identified by `number`.

## Path parameters

- `number` string, required

## Response `200`

The sender's WhatsApp templates.

- WhatsAppTemplateListResponse
  - `templates` WhatsAppTemplate[], required — Templates registered for the sender.
    - `uuid` string, uuid, required — Template ID.
    - `name` string, required — Template name.
    - `language` string, required — Template language code.
    - `category` 'marketing' | 'authentication' | 'utility', required — Template category.
    - `status` 'draft' | 'pending' | 'approved' | 'rejected' | 'paused' | 'flagged' | 'disabled' | 'in_appeal' | 'pending_deletion' | 'deleted' | 'unknown', required — Template review/approval status.
    - `quality_rating` 'high' | 'medium' | 'low' | 'unknown' | 'null', nullable — Template's messaging quality rating.
    - `submitted_at` string, nullable — Date and time the template was submitted for review, in ISO 8601 format.
    - `components` WhatsAppTemplateComponent[], required — Structural components of the template.
      - `type` 'HEADER' | 'BODY' | 'FOOTER' | 'BUTTONS', required — Component type.
      - `format` 'TEXT' | 'IMAGE' | 'VIDEO' | 'DOCUMENT' | 'LOCATION' — Header content format. Present on `HEADER` components only.
      - `text` string — Component text, with `{{n}}` placeholders where applicable.
      - `example` object — Sample values for the component's placeholders, in the shape the provider expects.
      - `buttons` object[] — Button definitions. Present on `BUTTONS` components only.
    - `created_at` string, required — Date and time the template was created, in ISO 8601 format.

## Other responses

- `400` — Returns when the request body or parameters are invalid.
- `401` — Returns when the request is not authenticated.
- `402` — Returns when the account balance is insufficient.
- `403` — Returns when the account is suspended.
- `404` — Returns when WhatsApp is not available or not enabled for the account, or no sender matches `number`.
- `429` — Returns when the account has exceeded its request rate limit.

## Changes

- **2026-09-23** `8bde78f383c6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/wavix/apis/wavix-apis/changes/v1/whatsapp/senders/:number/templates/get.md)

---

[API](https://skmtc.dev/wavix/apis/wavix-apis.md) · [All operations](https://skmtc.dev/wavix/apis/wavix-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/wavix/apis/wavix-apis/revisions/43ad912a102a?raw)