List Templates

Retrieve WhatsApp message templates associated with your Sendiee account. By default only unarchived templates are returned. You can optionally filter by approval status, category, and archive state. All query parameters are case-insensitive.

GET/v2.0/templates

Query Parameters

Parameter	Type	Required	Description
status	string	Optional	Filter by template approval status. Case-insensitive. One of: APPROVED, PENDING, REJECTED
category	string	Optional	Filter by template category. Case-insensitive. One of: authentication, marketing, utility
archived	string	Optional	Filter by archive state. Case-insensitive. Defaults to false (unarchived only). One of: false (unarchived only), true (archived only), all (both)

Code Examples

curl 'https://api.sendiee.com/v2.0/templates?status=approved&category=utility' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Response

{
  "success": true,
  "data": [
    {
      "_id": "a1b2c3d4e5f6a1b2c3d4e5f6",
      "name": "order_shipped_notification",
      "language": "en",
      "category": "UTILITY",
      "parameter_format": "POSITIONAL",
      "components": [
        {
          "type": "header",
          "format": "TEXT",
          "text": "Your order is on the way! 🚚"
        },
        {
          "type": "body",
          "text": "Hi {{1}}, your order #{{2}} has been shipped and is expected to arrive by {{3}}. Track your delivery using the link below.",
          "example": {
            "body_text": [
              [
                "Sarah",
                "ORD-98231",
                "April 14th"
              ]
            ]
          }
        },
        {
          "type": "footer",
          "text": "Reply STOP to unsubscribe."
        },
        {
          "type": "buttons",
          "buttons": [
            {
              "type": "url",
              "text": "Track Order",
              "url": "https://track.example.com/{{1}}",
              "example": [
                "ORD-98231"
              ]
            },
            {
              "type": "quick_reply",
              "text": "Contact Support"
            }
          ]
        }
      ],
      "status": "APPROVED",
      "quality_score": "HIGH",
      "templateId": 302948576120394,
      "submission_date": "2026-02-10T08:22:41.000Z",
      "rejection_reason": "NONE",
      "isArchived": false,
      "group": "transactional"
    },
    {
      "_id": "f9e8d7c6b5a4f9e8d7c6b5a4",
      "name": "verify_otp_login",
      "language": "en",
      "category": "AUTHENTICATION",
      "parameter_format": "POSITIONAL",
      "components": [
        {
          "type": "body",
          "text": "{{1}} is your one-time verification code. This code expires in 10 minutes. Do not share it with anyone.",
          "example": {
            "body_text": [
              [
                "847392"
              ]
            ]
          }
        },
        {
          "type": "buttons",
          "buttons": [
            {
              "type": "otp",
              "otp_type": "copy_code",
              "text": "Copy Code"
            }
          ]
        }
      ],
      "status": "APPROVED",
      "quality_score": "HIGH",
      "templateId": 819203746501928,
      "submission_date": "2026-03-05T11:44:18.000Z",
      "rejection_reason": "NONE",
      "isArchived": false,
      "group": "authentication"
    }
  ],
  "total": 2
}

Try It

Try it — API Playground

API Key

Status

Filter by approval status