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

# List WhatsApp templates

`GET /v1/whatsapp/templates`

## Request

- Base URL: `https://api.wavix.com`
- URL: `https://api.wavix.com/v1/whatsapp/templates`
- Auth: HTTP bearer

Returns a paginated list of the WhatsApp templates in your account's WhatsApp Business Accounts, each with its review status and components.

Every send names a template by its `name` and `language`, and this is where those values come from.

**Behavior:** Templates are ordered from newest to oldest. When several filters are specified, a template must match all of them. Returns `404` when `sender` doesn't match a sender on your account.

**Requires:** Your account must have WhatsApp enabled, must have a subscription plan, and must not be blocked or suspended.

## Query parameters

- `waba_id` string
- `sender` string
- `status` 'draft' | 'pending' | 'approved' | 'rejected' | 'paused' | 'flagged' | 'disabled' | 'in_appeal' | 'pending_deletion' | 'deleted' | 'unknown'
- `name` string
- `language` string
- `page` integer
- `per_page` integer

## Response `200`

A paginated list of WhatsApp templates.

- WhatsAppTemplatePageResponse: Returned by `whatsapp_templates_list`.
  - `templates` WhatsAppTemplate[], required: Templates that match the request.
    - `uuid` string, uuid, required: ID of the template. Pass it to `whatsapp_templates_get` to check the review outcome.
    - `name` string, required: Template name.
    - `language` string, required: Template language code.
    - `category` 'marketing' | 'authentication' | 'utility', required: Template category. Possible values: - `marketing` — Promotions, offers, and other marketing content. - `authentication` — One-time passcodes for verifying a user. - `utility` — Transactional updates about an order or an account.
    - `status` 'draft' | 'pending' | 'approved' | 'rejected' | 'paused' | 'flagged' | 'disabled' | 'in_appeal' | 'pending_deletion' | 'deleted' | 'unknown', required: Template review status. Possible values: - `draft` — The template is created but not yet submitted to the provider. - `pending` — The provider is reviewing the template. - `approved` — The template is approved and can be sent. - `rejected` — The provider rejected the template. - `paused` — The provider paused the template. - `flagged` — The provider flagged the template. It can still be sent. - `disabled` — The template is disabled and can't be sent. - `in_appeal` — An appeal of the review decision is in progress. - `pending_deletion` — The template is being deleted. - `deleted` — The template was deleted. - `unknown` — The provider reported a status that Wavix doesn't recognize.
    - `quality_rating` 'high' | 'medium' | 'low' | 'unknown' | 'null', nullable, required: Template's messaging quality rating. Meta rates quality from customer feedback over the past seven days, such as blocks and reports. Possible values: - `high` — High quality. - `medium` — Medium quality. - `low` — Low quality. - `unknown` — Not rated yet.
    - `submitted_at` string, date-time: Date and time the template's state was last updated from WhatsApp, in ISO 8601 format.
    - `components` WhatsAppTemplateResponseComponent[], required: Structural components of the template.
      - `type` string, required: Component type: `header`, `body`, `footer`, `buttons`, or the lower-cased name of another section type carried over from an imported template, such as `carousel` or `limited_time_offer`.
      - `format` 'text' | 'image' | 'video' | 'document' | 'location': Header content format. Present on `header` components only. Possible values: - `text` — Text header. - `image` — Image header. - `video` — Video header. - `document` — Document header. - `location` — Location header.
      - `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.
    - `waba` WhatsAppWaba, required: A WhatsApp Business Account linked to your account, embedded in senders and templates.
      - `id` string, required: ID of the WhatsApp Business Account. Pass it to `whatsapp_wabas_get` to retrieve the account.
      - `name` string, nullable, required: Name of the WhatsApp Business Account.
    - `created_at` string, date-time, required: Date and time the template was created, in ISO 8601 format.
  - `pagination` Pagination, required
    - `current_page` integer, required: Current page number.
    - `per_page` integer, required: Number of records per page.
    - `total` integer, required: Total number of records.
    - `total_pages` integer, required: Total number of pages.

## Other responses

- `401`: Authentication failed or wasn't provided.
- `403`: Returns when the account is suspended, blocked, or has no subscription plan, or the API key has no access to the endpoint.
- `404`: WhatsApp isn't available for your account or isn't enabled yet, or `sender` isn't 6–20 digits or doesn't match one of your senders.
- `429`: Returns when the account has exceeded its request rate limit.
- `500`: Returns when an unexpected error occurs on the server; the request may be retried.
- `503`: Returns when the service is temporarily unavailable; the request may be retried.

## Changes

- **2026-10-07** `ea33150ace54`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wavix/apis/wavix-apis/changes/v1/whatsapp/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/f2dde79f05ab?raw)