Get Template Detail

What it does

Returns the current detail of a single template (by Meta sourceId). Data is read fresh directly from Meta (no caching); the app_id is verified to belong to the organization. With expand=components, the body/header/button details are included too.

Endpoint

GET /api/v1/wa/{app_id}/templates/{source_id}

Headers

string

required

Secret key in Bearer sk_... format. See Secret Key authentication.

Path parameters

string

required

Application ID. Must belong to the organization.

string

required

The template’s Meta ID.

Query parameters

string[]

components → also returns the components. Default: metadata only. See Template Expand.

Response

Type: Result[TemplateResponseModel] (single). The envelope is { "data": { ... }, "isSuccess": true }.

boolean

true when the request completed successfully.

object

Show data

string

The template’s Meta ID.

string

Template name.

string

Language code.

string

UTILITY, MARKETING, or AUTHENTICATION. See Template Category.

string

The review/lifecycle state: APPROVED, PENDING, REJECTED, PAUSED, DISABLED, IN_APPEAL, PENDING_DELETION, DELETED, LIMIT_EXCEEDED, or UNKNOWN. See Template Status for what each one means.

object[]

Component details. Returned only with expand=components. One entry per component; every field other than type is dropped when Meta does not report it.

Show component

string

Which component this is. See Template Component Type — HEADER, BODY, FOOTER, BUTTONS, CAROUSEL, or LIMITED_TIME_OFFER.

string

HEADER only: TEXT, IMAGE, VIDEO, DOCUMENT, LOCATION, or CAROUSEL. See Header Format.

string

The component’s text (HEADER with format: "TEXT", BODY, FOOTER).

object

Sample values Meta stores for the component’s variables or media.

Show example

string[]

Sample values for the TEXT header variables.

string[]

The media handle behind an IMAGE / VIDEO / DOCUMENT header.

string[]

The resolved media URL, when Meta returns one instead of a handle.

string[][]

Sample values for the body variables — a list of value sets, so it is nested one level deeper than headerText.

object[]

BUTTONS only. See the button object below.

object[]

CAROUSEL only. One entry per card, each holding its own components array whose items have the same shape as a top-level component but are limited to HEADER, BODY, and BUTTONS (see Card Component Type).

boolean

BODY of an AUTHENTICATION template: whether the security recommendation line is included.

integer

FOOTER of an AUTHENTICATION template: the code validity duration.

object

LIMITED_TIME_OFFER only: text (the banner label) and hasExpiration (whether the countdown is shown).

string

Meta’s quality rating: GREEN (high), YELLOW (medium), RED (low), or UNKNOWN (not yet rated).

string

Why Meta rejected the template: NONE, ABUSIVE_CONTENT, INVALID_FORMAT, PROMOTIONAL, TAG_CONTENT_MISMATCH, SCAM, INCORRECT_CATEGORY, or UNKNOWN. See Template Rejected Reason.

string

How variables are referenced: POSITIONAL ({{1}}, {{2}}), NAMED, or UNKNOWN.

component button object

Each item in a BUTTONS component’s buttons array — also used by carousel card buttons.

string

URL, PHONE_NUMBER, QUICK_REPLY, COPY_CODE, or OTP.

string

The label shown on the button.

string

URL buttons: the target link, possibly containing {{1}}.

string

PHONE_NUMBER buttons. Meta returns it in RFC3966 form (tel:+90-555-123-45-67), not the E.164 form you sent.

string[]

The dynamic-URL sample, or the COPY_CODE coupon code.

string

OTP buttons only: the OTP delivery mode.

string

ONE_TAP / ZERO_TAP autofill label.

string

ONE_TAP / ZERO_TAP Android package name.

string

ONE_TAP / ZERO_TAP Android signature hash.

boolean

ZERO_TAP terms acceptance flag.

Null fields (id, createdAt, updatedAt, messageSendTtlSeconds, correctCategory, previousCategory) are dropped from the response.

Examples

Demo 1 — detail (default, without components)

GET /api/v1/wa/{app_id}/templates/842802041844912
Authorization: Bearer sk_...

{
  "data": {
    "sourceId": "842802041844912",
    "name": "order_confirmation",
    "language": "en",
    "category": "UTILITY",
    "status": "APPROVED",
    "qualityScore": "GREEN",
    "rejectedReason": "NONE",
    "parameterFormat": "POSITIONAL"
  },
  "isSuccess": true
}

Demo 2 — detail + components (expand=components)

GET /api/v1/wa/{app_id}/templates/842802041844912?expand=components
Authorization: Bearer sk_...

{
  "data": {
    "sourceId": "842802041844912",
    "name": "order_confirmation",
    "language": "en",
    "category": "UTILITY",
    "status": "APPROVED",
    "components": [
      { "type": "HEADER", "format": "TEXT", "text": "Order #{{1}} confirmed", "example": { "headerText": ["12345"] } },
      { "type": "BODY", "text": "Hello {{1}}, your order {{2}} has been confirmed.", "example": { "bodyText": [["John", "#12345"]] } },
      { "type": "FOOTER", "text": "Sent via Connexease" },
      { "type": "BUTTONS", "buttons": [
        { "type": "URL", "text": "Track Order", "url": "https://example.com/track/{{1}}", "example": ["https://example.com/track/abc123"] },
        { "type": "PHONE_NUMBER", "text": "Call Us", "phone_number": "tel:+90-555-123-45-67" }
      ]}
    ],
    "qualityScore": "GREEN",
    "rejectedReason": "NONE",
    "parameterFormat": "POSITIONAL"
  },
  "isSuccess": true
}

Demo 3 — rejected template (rejectedReason populated)

GET /api/v1/wa/{app_id}/templates/1234567890?expand=components
Authorization: Bearer sk_...

{
  "data": {
    "sourceId": "1234567890",
    "name": "promo_blast",
    "language": "en",
    "category": "MARKETING",
    "status": "REJECTED",
    "components": [
      { "type": "BODY", "text": "Win big now {{1}}!!! Click fast!!!", "example": { "bodyText": [["John"]] } }
    ],
    "qualityScore": "UNKNOWN",
    "rejectedReason": "ABUSIVE_CONTENT",
    "parameterFormat": "POSITIONAL"
  },
  "isSuccess": true
}

Demo 4 — AUTHENTICATION template detail

GET /api/v1/wa/{app_id}/templates/9988776655?expand=components
Authorization: Bearer sk_...

{
  "data": {
    "sourceId": "9988776655",
    "name": "login_otp",
    "language": "en",
    "category": "AUTHENTICATION",
    "status": "APPROVED",
    "components": [
      { "type": "BODY", "addSecurityRecommendation": true },
      { "type": "FOOTER", "codeExpirationMinutes": 10 },
      { "type": "BUTTONS", "buttons": [ { "type": "OTP", "otp_type": "COPY_CODE", "text": "Copy code" } ] }
    ],
    "qualityScore": "UNKNOWN",
    "rejectedReason": "NONE",
    "parameterFormat": "POSITIONAL"
  },
  "isSuccess": true
}

Demo 5 — carousel template (cards)

A carousel returns a BODY bubble plus a CAROUSEL component whose cards each carry their own components.

GET /api/v1/wa/{app_id}/templates/1029384756129?expand=components
Authorization: Bearer sk_...

{
  "data": {
    "sourceId": "1029384756129",
    "name": "summer_catalog",
    "language": "en",
    "category": "MARKETING",
    "status": "APPROVED",
    "components": [
      { "type": "BODY", "text": "Hi {{1}}, here are this week's picks.", "example": { "bodyText": [["John"]] } },
      {
        "type": "CAROUSEL",
        "cards": [
          {
            "components": [
              { "type": "HEADER", "format": "IMAGE", "example": { "headerHandle": ["4::aW1hZ2UvcG5n:ARZ9k1card_one_handle"] } },
              { "type": "BODY", "text": "Linen shirts, now 30% off." },
              { "type": "BUTTONS", "buttons": [ { "type": "URL", "text": "View", "url": "https://example.com/shirts" } ] }
            ]
          },
          {
            "components": [
              { "type": "HEADER", "format": "IMAGE", "example": { "headerHandle": ["4::aW1hZ2UvcG5n:ARZ9k1card_two_handle"] } },
              { "type": "BODY", "text": "Summer dresses from $29." },
              { "type": "BUTTONS", "buttons": [ { "type": "URL", "text": "View", "url": "https://example.com/dresses" } ] }
            ]
          }
        ]
      }
    ],
    "qualityScore": "GREEN",
    "rejectedReason": "NONE",
    "parameterFormat": "POSITIONAL"
  },
  "isSuccess": true
}

Demo 6 — limited-time offer template

The offer comes back as its own LIMITED_TIME_OFFER component, separate from the body and buttons.

GET /api/v1/wa/{app_id}/templates/1029384756128?expand=components
Authorization: Bearer sk_...

{
  "data": {
    "sourceId": "1029384756128",
    "name": "flash_sale",
    "language": "en",
    "category": "MARKETING",
    "status": "APPROVED",
    "components": [
      { "type": "HEADER", "format": "IMAGE", "example": { "headerHandle": ["4::aW1hZ2UvcG5n:ARZ9k1sample_handle_value"] } },
      { "type": "BODY", "text": "Hi {{1}}, your flash discount is live.", "example": { "bodyText": [["John"]] } },
      { "type": "LIMITED_TIME_OFFER", "limitedTimeOffer": { "text": "Expiring offer!", "hasExpiration": true } },
      { "type": "BUTTONS", "buttons": [
        { "type": "COPY_CODE", "example": ["FLASH40"] },
        { "type": "URL", "text": "Shop now", "url": "https://example.com/flash" }
      ]}
    ],
    "qualityScore": "GREEN",
    "rejectedReason": "NONE",
    "parameterFormat": "POSITIONAL"
  },
  "isSuccess": true
}

Demo 7 — not found (invalid source_id) → 404

GET /api/v1/wa/{app_id}/templates/0000000000
Authorization: Bearer sk_...

{
  "errors": {
    "code": "META_075",
    "group": "NOT_FOUND",
    "description": "Template with 0000000000 not found in Meta."
  },
  "isSuccess": false
}

Errors

object

Error details with code, group, and description; isSuccess is false.

Auth / tenant

HTTP	Code	When
401	`ORGANIZATION_SECRET_010`	Secret key is missing.
401	`ORGANIZATION_SECRET_011`	Secret key is invalid.
404	`APPLICATION_004`	`app_id` does not belong to the organization.

Request validation (422)

HTTP	When
422	Invalid `expand` value (anything other than `components`).

Meta-side

HTTP	Code	When
404	`META_075`	`source_id` not found (Meta `code=100` is treated as not found).
401	`META_034`	Token invalid/expired (190).
403	`META_035`	Permission denied (10 / 200–299).
429	`META_036`	Rate limit (4 / 80007).
502	`META_004`	General/fallback fetch error.

Getting Started

Analytics

Application

Template

Media

Developers

Reference

What it does

Endpoint

Headers

Path parameters

Query parameters

Response

component button object

Examples

Errors

Auth / tenant

Request validation (422)

Meta-side

​What it does

​Endpoint

​Headers

​Path parameters

​Query parameters

​Response

​component button object

​Examples

​Errors

​Auth / tenant

​Request validation (422)

​Meta-side

What it does

Endpoint

Headers

Path parameters

Query parameters

Response

component button object

Examples

Errors

Auth / tenant

Request validation (422)

Meta-side