API and developers

List approved templates

get/v1/templates

List the templates this merchant can send right now.

Only templates approved in Meta are listed, because only those can be sent: naming an unapproved one in a send is rejected with 422. Each entry carries the name, the language and the variable keys a send must supply.

An empty list means no template has been approved and mirrored for this account yet, and every send will be rejected until one is.

Example

curl -X GET "https://api.ya.onl/v1/templates" \
  -H "X-API-Key: yv_live_v1_…"

Parameters

pageintegerquerydefault: 1

Page number (1-indexed)

limitintegerquerydefault: 25

Number of items per page (max 100)

Responses

200

Successful Response

401

Invalid or missing API key

403

API key lacks the outbound:read scope

422

Validation Error

429

Rate limit exceeded