Get Template List and Statuses · WABPO Developer Documentation
Get Template List and Statuses
Retrieve a filtered list of your WhatsApp message templates based on their current lifecycle state. This API allows you to query and track templates that are saved locally as drafts, awaiting review (pending), cleared for production (approved), or turned down by Meta (rejected).
Fetch & Filter WhatsApp Templates
Use this endpoint to retrieve templates linked to a specific customer project. By default, this API returns only approved, sendable templates. You can pass query parameters to view local drafts, pending submissions, or rejected templates with their reason logs.
HTTP Method:GET
URL:https://api.wabpo.com/api/v1/public/templates
Headers:HTTPAuthorization: Bearer YOUR_API_KEY
Query Parameters
Parameter
Type
Required
Description
projectId
String
Yes
The project ID containing the target templates.
status
String
No
Filter by template life-cycle state. Options: ALL, DRAFT, PENDING, REJECTED. If omitted, returns approved templates only.
templateType
String
No
Filter by layout asset: TEXT, IMAGE, VIDEO, DOCUMENT, CAROUSEL, or LOCATION.
category
String
No
Filter by business purpose: UTILITY, MARKETING, or AUTHENTICATION.
search
String
No
String to query against template names or body text snippets.
Request & Response Examples
Example 1: Fetch Approved Templates Only (Default)
Run this query to show lists of ready-to-use templates that can immediately be sent out to users.
Run this query to fetch items turned down by Meta. Use the rejectionReason block to display feedback inside your system UI so users can fix copy mistakes.
HTTP
GET /api/v1/public/templates?projectId=PROJECT_ID&status=REJECTED
Response (200 OK)
JSON
{
"success": true,
"data": [
{
"id": "REJECTED_TEMPLATE_4",
"templateName": "discount_blast",
"category": "MARKETING",
"templateType": "TEXT",
"status": "REJECTED",
"metaStatus": "REJECTED",
"metaStatusReason": "Template text is unclear or violates WhatsApp policy.",
"rejectionReason": "Template text is unclear or violates WhatsApp policy."
}
]
}
Example 5: Fetch Everything (All States Combined)
Pass status=ALL along with specific layout types or search parameters to execute broad audit logs.
HTTP
GET /api/v1/public/templates?projectId=PROJECT_ID&status=ALL&templateType=TEXT&search=order
Fetching a Single Template by ID
If you need to view the full details of one specific template item (e.g., when building a single template profile or detail page), bypass the list parameters and call the direct ID path.
