This API retrieves a list of all 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 catagory (MARKETING, UTILITY, AUTHENTICATION)
- Supports comma-separated values
Pagination
Break up large sets of data into smaller, manageable chunks instead of loading everything at once.
- limit - Determines how many items to fetch per page (e.g., 10 templates), default 50, max 200
- offset - Determines how many items to skip before starting (e.g., skip the first 20)
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 Meta-approved templates are returned — Meta's quality status is not reflected in the response.
- The API returns the template business “friendly name” when defined. If not, it defaults to the official WhatsApp business name.
Request Example:
GET /whatsapp/templates/Y0nJy1h_buU91T6QNroQ%3d?language=en&category=MARKETING
API key is needed to authorize requests. You can get your API key via the management console.
A Bearer Token is needed to be set in the Authorization header of every API call.
For additional support you can contact us.
The encrypted ID of the channel
Operation successful
ISO 8601 timestamp of when the response was generated
The main response payload.
List of Meta-approved WhatsApp message templates.
Template's name
Language code of the template.
Template category. Possible values: UTILITY, MARKETING, AUTHENTICATION
Approval status of the template. Only APPROVED templates are returned.
Optional header component of the template.
Header format type. Possible values: TEXT, IMAGE, VIDEO, DOCUMENT.
Header text content, may include variable placeholders.
List of variable names mapped to placeholders in the header text.
Main body content of the template.
Body text content, may include variable placeholders.
List of variable names mapped to placeholders in the body text, in order.
Optional footer component of the template.
Static footer text. Does not support variable placeholders.
Optional list of buttons attached to the template.
Button type. Possible values: QUICK_REPLY, URL, PHONE.
Display label of the button.
Unique template ID assigned by Meta.
Pagination metadata for the current response.
Total number of approved templates available for this channel.
Maximum number of templates requested per page.
Number of templates skipped. 0 indicates the first page.
Bad request, could not process the input data
{
"status": "400",
"description": "Missing parameter templateName",
"response_time": "2026-08-06T07:51:52.258Z"
}Error status code as string
Human-readable description of the error
Timestamp of the response
Array of recipient error details
Recipient's phone number
Error status code
Failure reason
Unauthorized - The supplied credentials, if any, are not sufficient to access the resource
Not found - The requested resource is not found
Too Many Requests - Too many requests have been made in a short period of time (Throttling)
Server Error - The server could not return the representation due to an internal server error