Skip to main content
GET
List templates

Authorizations

Authorization
string
header
required

An org API key: Authorization: Bearer oak_….

Query Parameters

limit
integer
default:50
Required range: 1 <= x <= 200
cursor
string | null
q
string | null
status
enum<string>[] | null

Lifecycle status of a WhatsApp message template. DRAFT is local-only (authored but never submitted to Meta); every other value mirrors a Meta review state. A template starts DRAFT, moves to PENDING on submit, then Meta drives it to APPROVED / REJECTED and later PAUSED / DISABLED via the template-status webhook.

Available options:
DRAFT,
PENDING,
APPROVED,
REJECTED,
PAUSED,
DISABLED,
IN_APPEAL,
PENDING_DELETION
category
enum<string>[] | null

WhatsApp message-template category. Mirrors Meta's template categories and the Postgres template_category_enum. Meta may auto-recategorize a template after review; the webhook handler reconciles ours to match.

Available options:
MARKETING,
UTILITY,
AUTHENTICATION
language
string[] | null

Response

Successful Response

items
PublicTemplate · object[]
required
next_cursor
string | null
required
total_count
integer | null