---
title: "Retrieve a WhatsApp template"
method: GET
path: "/v1/whatsapp/templates/{uuid}"
tags: ["WhatsApp"]
---

# Retrieve a WhatsApp template

`GET /v1/whatsapp/templates/{uuid}`

## Request

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

Returns the WhatsApp template with the given ID, including its review status, components, and WhatsApp Business Account.

A new template's review outcome isn't known when `whatsapp_templates_create` returns, so the `approved` or `rejected` status shows up here.

**Behavior:** Returns `404` when no template with this ID belongs to your account's WhatsApp Business Accounts.

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

## Path parameters

- `uuid` string, uuid, required

## Response `200`

The requested WhatsApp template.

- WhatsAppTemplateResponse: Returned by `whatsapp_templates_get` and `whatsapp_templates_create`.
  - `template` WhatsAppTemplate, required: A WhatsApp message template with its review status and components. Returned by `whatsapp_templates_list`, `whatsapp_templates_get`, and `whatsapp_templates_create`.
    - `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.

## 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 no template with this ID belongs to your account.
- `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/:uuid/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)