WAwavix
WhatsApp

List WhatsApp templates

Changed on

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.

get/v1/whatsapp/templates

Request

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

Query parameters

waba_idstring

Filters templates by the ID of the WhatsApp Business Account that owns them, as returned in waba.id by whatsapp_senders_list.

senderstring

Filters templates by the WhatsApp Business Account of the sender with this phone number, in E.164 format. The leading + is optional.

status'draft' | 'pending' | 'approved' | 'rejected' | 'paused' | 'flagged' | 'disabled' | 'in_appeal' | 'pending_deletion' | 'deleted' | 'unknown'

Filters templates by 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.
namestring

Filters templates by name.

languagestring

Filters templates by language code.

pageinteger

Page number to retrieve. Page numbering starts at 1. Defaults to 1.

per_pageinteger

Number of records to return per page. Defaults to 25. Values above 100 are treated as 100.

Response

A paginated list of WhatsApp templates.

Example response

{
  "templates": [
    {
      "uuid": "6b1f3c52-9e0a-4d7b-8a15-c2f4e9d07b38",
      "name": "order_shipped",
      "language": "en_US",
      "category": "utility",
      "status": "approved",
      "quality_rating": "high",
      "submitted_at": "2026-01-15T10:30:00Z",
      "components": [
        {
          "type": "body",
          "format": "text",
          "text": "Hi {{1}}, your order {{2}} has shipped."
        }
      ],
      "waba": {
        "id": "102290129340398",
        "name": "Acme Support"
      },
      "created_at": "2026-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "current_page": 2,
    "per_page": 25,
    "total": 101,
    "total_pages": 5
  }
}

Changes