> ## Documentation Index > Fetch the complete documentation index at: https://help.commbox.io/llms.txt > Use this file to discover all available pages before exploring further. # Get WhatsApp Templates > This API retrieves a list of all active Meta-approved WhatsApp message templates configured for a specified channel. ### Path Parameters Required Path parameter is the **Encrypted Channel ID**, which can be found in the **WhatsApp Channel Settings** beneath the channel's name. ### Query Parameters Query parameters can filter and organize the request: **Language** - Enter the template's language code (en, he, es, etc.) - Supports comma-separated values **Category** - Enter the WhatsApp template category (Marketing, Utility, Authentication) - Supports comma-separated values **Pagination (limit and offset)** These optional query parameters help control and manage the returned WhatsApp templates by splitting them into smaller, manageable chunks. - **limit** - Number of templates to return per request (default: 50, max: 200) - **offset** - Page index indicating where to start retrieving results (0, 1, 2, ...). The starting point is calculated as: start_index = offset × limit (default: 0) Example: If there are 50 templates and the limit = 20: - offset = 0 → returns templates 1–20 - offset = 1 → returns templates 21–40 - offset = 2 → returns templates 41–50 ### Response Payload The response payload may include: - Variable placeholders (e.g., {{1}}, {{2}}) - Header format types (TEXT, IMAGE, VIDEO, DOCUMENT) - Button types (QUICK_REPLY, URL, PHONE). **Note:** - Only templates that are approved by Meta and active in CommBox are returned; Meta's quality status is not included in the response. - The API returns the template business “friendly name” when defined. If not, it defaults to the official WhatsApp business name. - Although offset conceptually represents skipped items, in this API it is page-based, not item-based. ### Request Examples: All active and approved Marketing templates in English: `GET /whatsapp/templates/Y0nJy1h_buU91T6QNroQ%3d?language=en&category=marketing` Retrieving 20 active and approved templates – the 2nd batch of 20 out of 50: `GET /whatsapp/templates/Y0nJy1h_buU91T6QNroQ%3d?limit=20&offset=1` ## OpenAPI ````json GET /whatsapp/templates/{ENCRYPTED_STREAM_ID} { "openapi": "3.0.3", "info": { "title": "CommBox API", "x-logo": { "url": "https://www.commbox.io/logo/commbox_logo_large.png" }, "version": "2.07", "termsOfService": "https://www.commbox.io/end-user-license-agreement-eula/", "contact": { "name": "commbox", "url": "https://www.commbox.io", "email": "contactus@commbox.io" } }, "servers": [ { "url": "https://api.commbox.io/", "description": "Production server" } ], "security": [ { "BearerAuth": [] } ], "tags": [ { "name": "Core", "description": "

Systemwide verification" }, { "name": "Objects", "description": "

Objects are conversations between the AI Agent or the human agent and the customers, where each segment of the conversation is referred to as a Child. Every conversation must have a designated Stream – a communication channel such as Chat, Email, Text/SMS, etc., through which the conversation takes place.
The Object APIs category concentrates on a specific conversation, where the Stream is part of the identifying parameters. In contrast, the Streams APIs category, the Channel is the focal point of the request, and the objects and users are the filtering aspects." }, { "name": "Media", "description": "Converting media files to Base64" }, { "name": "AI Services", "description": "APIs that provide AI capabilities by the platform. " }, { "name": "Streams", "description": "

Streams are communication channels used in CommBox, such as Chat, WhatsApp, SMS/Text, etc. In the Streams category of APIs, the channel is the focal point of the request, and the objects and users are the filtering aspects. See the Enums Section for available channels and their CommBox code." }, { "name": "Tags", "description": "

Tags are a classification tool for summarizing aspects of the conversation or the user. It can mark the conversation to indicate a new sale or identify a customer as not interested in the product. To help manage the Tags assets, Tags can be grouped with a common identifier." }, { "name": "SMS", "description": "

Sending customers **SMS messages** (Texting) requires an initial opt-in step, which is not offered by CommBox and is the sole responsibility of the sending entity (Business)." }, { "name": "WhatsApp", "description": "

CommBox facilitates activities in **WABA** for the clients. Our platform helps clients create new templates and manage existing ones.

**Opt-in for WhatsApp**
Before sending WhatsApp messages to someone, you must first receive opt-in permission confirming that they wish to receive future messages from you on WhatsApp. This can be done using any channel your business uses to communicate with people — your website, app, email, retail location, etc.