Skip to Content
CallMitraDocs
API referenceWhatsapp

List WhatsApp templates

Templates of your WhatsApp Business accounts, to pick `template.name` and `template.language`.

GET
/api/v1/whatsapp/message-templates

Templates of your WhatsApp Business accounts, to pick template.name and template.language.

Authorization

headerX-API-Key<token>

Create in the console: Settings → API & webhooks.

Query Parameters

phoneId?|

Only templates usable from this sending number.

status?|

Filter by review status, e.g. APPROVED.

category?|

MARKETING, UTILITY or AUTHENTICATION.

q?|

Part of the template name.

Response Body

OK

application/json
  1. response
templates*array<>

Templates, sorted by name and language (up to 500).

[key: string]?any
Example Request
curl -X GET 'https://api.callmitra.ai/api/v1/whatsapp/message-templates'
Example Response
{  "templates": [    {      "category": "UTILITY",      "components": [        {          "text": "Hi {{1}}, your order {{2}} is on its way.",          "type": "BODY"        },        {          "text": "Reply STOP to opt out",          "type": "FOOTER"        }      ],      "id": "2e8d4f6a-1b3c-4d5e-9f7a-8b9c0d1e2f3a",      "language": "en",      "lastSyncedAt": "2026-01-15T08:00:00+00:00",      "name": "order_update",      "parameterFormat": "POSITIONAL",      "qualityScore": "GREEN",      "status": "APPROVED"    }  ]}