List templates

GET /api/v1/get_templates

Returns your approved templates for the API key's WhatsApp number. Use the returned id as template_id in Send a template, and read each template's structure to know which variables to pass.

No query parameters. Only the Authorization header is needed.

Request

curl https://api.getkanal.com/api/v1/get_templates \
  -H "Authorization: Bearer 8fK2pX9mWq4Ld7Vb3Nc6Ts1Z"

Response 200 OK

A JSON array of template objects (only APPROVED ones are returned):

[
  {
    "id": 1234,
    "phone_number_id": 56,
    "name": "order_confirmation",
    "wa_status": "APPROVED",
    "structure": "{ ...JSON: header/body/buttons with variable names... }",
    "created_at": "2026-01-10T12:00:00.000000Z",
    "updated_at": "2026-01-11T09:30:00.000000Z"
  }
]

structure is a JSON string. It describes the header, body (variables[].name) and buttons. The variable names found there are exactly the keys you pass in the variables object when sending the template.

Errors

Only the shared auth/subscription errors apply: 401 ({ "error": "Invalid API key" }) and 403 ({ "error": "Team has no active subscription" }).