Fetch WhatsApp Templates

Two endpoints return your WhatsApp templates: the primary OneXtel /templates/fetch endpoint (filterable, paginated), and a Meta-passthrough endpoint used for CleverTap integrations.

OneXtel Fetch Templates

Endpoint

POST /templates/fetch

Headers

string

required

API key generated for the TUC.

string

application/json

string

required

application/json

Request body

string

required

Messaging channel. Must be WhatsApp.

string

required

WhatsApp Business Account (WABA) identifier.

integer

required

Page number for pagination. Must be a non-negative integer.

integer

required

Number of records to return per page.

string

Template category filter, e.g. Marketing, Utility, Authentication.

string

Filters templates created on or after the given time. Local datetime format YYYY-MM-DDTHH:mm:ss.

string

WhatsApp template name to filter by.

string

Template language code, e.g. en_US.

string

Template lifecycle status filter: Approved, Pending, or Rejected.

Send channel, wabaId, pageNo, and limit on every request. Filter by date with createdDate.

cURL

curl --location 'https://api.onexaura.com/templates/fetch' \
--header 'apikey: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "channel": "WhatsApp",
    "wabaId": "YOUR_WABA_ID",
    "category": "Marketing",
    "createdDate": "2025-10-22T12:02:28",
    "templateName": "lto_00012",
    "language": "en_US",
    "status": "pending",
    "pageNo": 0,
    "limit": 5
}'

Response

{
  "page_details": {
    "pageNo": 0,
    "limit": 5
  },
  "data": [
    {
      "id": "1521226662554788",
      "name": "lto_00012",
      "status": "Pending",
      "category": "MARKETING",
      "language": "en_US",
      "components": [
        {
          "text": "Hi {{1}},\n\nYour new order with id - {{2}} has been placed successfully. \n\nPlease check below to see the status of your updates.",
          "type": "BODY",
          "example": {
            "body_text": [["sarthak", "23432"]]
          }
        },
        {
          "type": "LIMITED_TIME_OFFER",
          "limited_time_offer": {
            "text": "Expiring offer!",
            "has_expiration": true
          }
        },
        {
          "type": "BUTTONS",
          "buttons": [
            {
              "text": "Copy offer code",
              "type": "COPY_CODE",
              "example": ["50OFF"]
            },
            {
              "url": "https://bitly.com/{{1}}",
              "text": "Visit website",
              "type": "URL",
              "example": ["EXAMPLE"]
            }
          ]
        }
      ],
      "parameter_format": "POSITIONAL",
      "created_on": "2025-10-22T12:02:28.963",
      "updated_on": "2025-10-31T06:21:05.142",
      "previous_category": null,
      "quality_score": null
    }
  ]
}

object

Echoes back the pagination request.

Show page_details

integer

Page number returned.

integer

Page size returned.

array

Array of template objects matching the filter.

Show template object

string

Meta template ID.

string

Template name.

string

Approval status: Approved, Pending, or Rejected.

string

Template category, e.g. MARKETING.

string

Template language code.

array

Full component definition as originally submitted (BODY, header, footer, LIMITED_TIME_OFFER, BUTTONS, etc. — matches the create-template component shapes).

string

POSITIONAL or NAMED.

string

Template creation timestamp.

string

Last status/update timestamp.

string | null

Prior category if the template category was changed by Meta; null otherwise.

string | null

Meta quality rating; null if not yet scored.

CleverTap Fetch Templates

A separate GET endpoint returns templates directly in Meta’s native format, intended for CleverTap integrations.

Endpoint

GET /oapi/meta/templates/fetch

Headers

string

required

API key for the TUC.

string

required

WhatsApp Business Account ID.

Query parameters

integer

Maximum number of templates to return. Example: 500.

cURL

curl --location 'https://api.onexaura.com/oapi/meta/templates/fetch?limit=500' \
--header 'apikey: YOUR_API_KEY' \
--header 'wabaid: YOUR_WABA_ID'

WhatsApp

RCS

SMS (India)

SMS (International)

OmniChannel

Verify

Fetch WhatsApp Templates

OneXtel Fetch Templates

Endpoint

Headers

Request body

cURL

Response

CleverTap Fetch Templates

Endpoint

Headers

Query parameters

cURL

​OneXtel Fetch Templates

​Endpoint

​Headers

​Request body

​cURL

​Response

​CleverTap Fetch Templates

​Endpoint

​Headers

​Query parameters

​cURL

OneXtel Fetch Templates

Endpoint

Headers

Request body

cURL

Response

CleverTap Fetch Templates

Endpoint

Headers

Query parameters

cURL