List templates

GET 
/templates

Lists the WABA's templates from the local mirror. If the mirror is older than 15 minutes, a sync with Meta runs before responding.

The stale and syncedAt fields tell you whether what you got is fresh. When a sync runs, its summary comes in sync; if it fails, the reason comes in syncError — but the cached data is still returned.

Request

Responses

200

Template list.

401

Missing, malformed, unknown or revoked token (authentication), or a suspended account (tenant_inactive).

403

The resource does not belong to your account (forbidden), or the path is on the mirror's block list (forbidden_endpoint), or your API key is limited to some numbers and the operation covers the whole account (forbidden).

409

No WhatsApp Business Account connected and wabaId omitted (no_waba).

422

Payload failed validation (invalid_request, detailed in issues) or was rejected by Meta (meta_error, with the original body in meta).

429

Rate limit exceeded (rate_limit).

Response Headers

Retry-After

Seconds to wait before retrying.

X-RateLimit-Category

Which rate limit category applied — send, media or default.

X-RateLimit-Scope

Which bucket the other headers describe — key (the API key), session (the dashboard) or account (the account ceiling).

X-RateLimit-Limit

Request ceiling for this category in the current window.

X-RateLimit-Remaining

Requests left in the current window.