Skip to main content
GET
Get Templates

Authorizations

Authorization
string
header
required

Secret key in Bearer sk_... format. Server-to-server only — never embed it in a browser or mobile client. The organization is resolved from the key, so organization_id is never passed explicitly.

Path Parameters

app_id
string
required

Application ID. Must belong to the organization resolved from your secret key, otherwise the request returns 404 with APPLICATION_004.

Example:

"app_7poyXj8GXuv76e"

Query Parameters

limit
integer
default:20

Maximum records per page.

Required range: 1 <= x <= 100
after
string

Next-page cursor — the nextCursor from a previous response. Do not pass it on the first request.

before
string

Previous-page cursor — the previousCursor from a response. Cannot be combined with after.

status
enum<string>

Status filter. Any other value returns 422. Review and lifecycle status. UNKNOWN means Meta reported a status this API does not recognise.

Available options:
APPROVED,
PENDING,
REJECTED,
PAUSED,
DISABLED,
IN_APPEAL,
PENDING_DELETION,
DELETED,
LIMIT_EXCEEDED,
UNKNOWN
category
enum<string>

Category filter. Any other value returns 422. Determines which components are allowed. UTILITY for transactional messages, MARKETING for promotional, AUTHENTICATION for one-time passcodes.

Available options:
UTILITY,
MARKETING,
AUTHENTICATION
language
string

Language filter, a BCP-47 code such as en or tr. Unlike the language field on create, this filter is a plain string passed to Meta as-is and is not restricted to the closed language list.

Meta name_or_content search — matches the template name or its body text.

expand
enum<string>[]

Repeatable. components also returns the components, which are omitted by default. Any other value is rejected with 422.

Available options:
components

Response

A page of templates plus its paging metadata.

data
object[]
pagingMetadata
object
isSuccess
enum<boolean>
Available options:
true