List templates

gethttps://api.whatsable.app/v1/templates

Build a request to copy

This page never sends a request. Fill in the fields, then copy the request and run it from your server.

AuthorizationYour API key, from Settings > API keys. The request sends it as a bearer token.limit query parameter, optionalcursor query parameter, optionalstatus query parameter, optionalnumber_id query parameter, optionalname query parameter, optionallanguage query parameter, optional

Request

curl -X GET 'https://api.whatsable.app/v1/templates'

Lists the templates of the WhatsApp Business Accounts that own the numbers of this key, newest first.

Authorization

bearerAuth

headerAuthorizationBearer <nfy_live_<32 characters>>

An API key from Settings > API keys, sent as Authorization: Bearer <key>.

Query Parameters

limit?integer

How many items to return, 1 to 100.

Range1 <= value <= 100

Default25

cursor?string

The next_cursor of the previous page. An expired or malformed cursor answers 400 invalid_cursor.

Length1 <= length <= 512

status?string

Only templates in this status, such as approved.

Length1 <= length <= 32

number_id?string

Only templates of this number's WhatsApp Business Account.

Length1 <= length <= 64

name?string

Only templates with this exact name.

Length1 <= length <= 512

language?string

Only templates in this language, such as en_US.

Length1 <= length <= 15

Response Body

A page of templates, newest first.

application/json

response

object*string

data*array<>

has_more*boolean

True when another page follows this one.

next_cursor*|

Pass as cursor to read the next page. Null on the last page. Valid for 24 hours.

Example Request

curl -X GET 'https://api.whatsable.app/v1/templates'

Example Request

curl -X GET 'https://api.whatsable.app/v1/templates'

Example ResponseSchema

{
  "object": "list",
  "data": [
    {
      "object": "template",
      "id": "cm2v8t1a00001qz8habcd1234",
      "name": "order_shipped",
      "display_name": "Order shipped",
      "language": "en_US",
      "category": "utility",
      "status": "approved",
      "rejected_reason": null,
      "waba_id": "9876543210",
      "body": "Hi {{1}}, your order {{2}} is on its way.",
      "parameter_format": "positional",
      "variables": [
        {
          "key": "header_image",
          "component": "header",
          "type": "image",
          "required": true,
          "example": null
        },
        {
          "key": "1",
          "component": "body",
          "type": "text",
          "required": true,
          "example": "Ana"
        },
        {
          "key": "2",
          "component": "body",
          "type": "text",
          "required": true,
          "example": "#1042"
        },
        {
          "key": "button_0",
          "component": "button",
          "type": "text",
          "required": true,
          "example": "1042"
        }
      ],
      "buttons": [
        {
          "type": "url",
          "text": "Track",
          "url": "https://acme.example/t/{{1}}",
          "phone": null
        }
      ],
      "created_at": "2026-09-01T12:00:00Z",
      "updated_at": "2026-09-02T08:00:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}

{  "object": "list",  "data": [    {      "object": "template",      "id": "cm2v8t1a00001qz8habcd1234",      "name": "order_shipped",      "display_name": "Order shipped",      "language": "en_US",      "category": "utility",      "status": "approved",      "rejected_reason": null,      "waba_id": "9876543210",      "body": "Hi {{1}}, your order {{2}} is on its way.",      "parameter_format": "positional",      "variables": [        {          "key": "header_image",          "component": "header",          "type": "image",          "required": true,          "example": null        },        {          "key": "1",          "component": "body",          "type": "text",          "required": true,          "example": "Ana"        },        {          "key": "2",          "component": "body",          "type": "text",          "required": true,          "example": "#1042"        },        {          "key": "button_0",          "component": "button",          "type": "text",          "required": true,          "example": "1042"        }      ],      "buttons": [        {          "type": "url",          "text": "Track",          "url": "https://acme.example/t/{{1}}",          "phone": null        }      ],      "created_at": "2026-09-01T12:00:00Z",      "updated_at": "2026-09-02T08:00:00Z"    }  ],  "has_more": true,  "next_cursor": "string"}

AuthorizationCopy Anchor Link

Query ParametersCopy Anchor Link

Response BodyCopy Anchor Link

Authorization

Query Parameters

Response Body