Skip to main content
GET
List templates

Authorizations

Authorization
string
header
required

A workspace API token (sk_live_...) or an OAuth access token (oat_live_...). Create workspace tokens in Settings > API. Send either as Authorization: Bearer <token>.

Query Parameters

channel_id
string[] | null

Only templates on this channel. Repeat to match any of several.

Unique identifier for a channel.

Pattern: ^chn_[0-9a-f]{32}$
status
enum<string>[] | null

Only templates in this status. Repeat to match any of several.

Where a template stands with WhatsApp on its channel.

Only approved templates can be sent. pending is awaiting review (or still being submitted). rejected was refused, or could not be submitted. paused was approved but is suspended, usually for low quality.

Available options:
approved,
pending,
rejected,
paused
limit
integer
default:50

Items per page (max 200).

Required range: 1 <= x <= 200
cursor
string | null

Opaque cursor from a previous response's links.next.

Response

Successful Response

A page of templates.

data
Template · object[]
required
meta
PageMeta · object
required