Get WABA Templates by Number

List the WhatsApp Business API (WABA) message templates available for a given phone number. Use this to obtain template names and UUIDs before sending template messages via the Send WABA Message endpoint.

info

Requires a WhatsApp Business API (WABA) channel connected to your 2Chat account. See How to connect WABA to 2Chat.

Query parameters

Parameter	Description	Example
phone_number	The WABA number in E.164 format: no spaces, with leading plus sign. Required.	+5215512345432
page	Zero-based page index for pagination. Default is 0.	0

Invocation

cURL

curl --request GET \
  --url 'https://api.p.2chat.io/open/waba/templates?phone_number=+5215512345432&page=0' \
  --header 'Content-Type: application/json' \
  --header 'X-User-API-Key: your_api_key_here'

Python

import requests

url = "https://api.p.2chat.io/open/waba/templates"
params = {"phone_number": "+5215512345432", "page": 0}
headers = {
  "Content-Type": "application/json",
  "X-User-API-Key": "your_api_key_here"
}

response = requests.get(url, params=params, headers=headers)
print(response.json())

JavaScript

const axios = require('axios');

axios.get('https://api.p.2chat.io/open/waba/templates', {
  params: { phone_number: '+5215512345432', page: 0 },
  headers: {
    'Content-Type': 'application/json',
    'X-User-API-Key': 'your_api_key_here'
  }
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

Response

The API returns a paginated list of templates for the given WABA number.

{
  "success": true,
  "templates": [
    {
      "uuid": "TMP1b44a079-c75c-4403-bc8f-a75c4ce5cd23",
      "name": "template_for_tracking_utilities",
      "status": "APPROVED",
      "category": "UTILITY",
      "template_content": "2Chat Team\nHi {{1}}.\n\nWe are writing you to ask you if you receive our package with track-id {{2}}.\n\nPlease confirm",
      "description": null,
      "updated_at": "2026-02-03T20:09:28Z",
      "waba": {
        "uuid": "WAN3ff9fb72-6ecd-4c2a-9055-4836d8ed33d7",
        "friendly_name": "2Chat Gupshup Integration",
        "iso_country_code": "US",
        "verified_name": "APPROVED",
        "phone_number": "+16173518454",
        "connection_status": "C",
        "created_at": "2025-11-19 23:04:18",
        "updated_at": "2026-02-02 19:41:12"
      }
    }
  ],
  "total": 21,
  "next_page": 1
}

Field	Description
success	true when the request succeeded
templates	Array of template objects
templates[].uuid	Template UUID; use this as template_uuid when sending a template message
templates[].name	Template name (lowercase with underscores)
templates[].status	Meta approval status: APPROVED, PENDING, REJECTED, or FAILED
templates[].category	Template category (e.g. UTILITY, MARKETING, AUTHENTICATION)
templates[].template_content	Full template text including header, body, footer and placeholders ({{1}}, {{2}}, …)
templates[].description	Optional template description, or null
templates[].updated_at	Last update time (ISO 8601)
templates[].waba	WABA (WhatsApp Business Account) this template belongs to
templates[].waba.uuid	WABA UUID
templates[].waba.friendly_name	Display name of the WABA connection
templates[].waba.iso_country_code	Two-letter country code (e.g. US)
templates[].waba.verified_name	Meta verification status (e.g. APPROVED)
templates[].waba.phone_number	WABA phone number in E.164 format
templates[].waba.connection_status	Connection status (e.g. C = connected)
templates[].waba.created_at	WABA creation timestamp
templates[].waba.updated_at	WABA last update timestamp
total	Total number of templates across all pages
next_page	Zero-based index of the next page, or null when there are no more pages