> ## Documentation Index
> Fetch the complete documentation index at: https://docs.connectly.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Templates

> List all WhatsApp templates for your account, including their approval status and components 📋

Retrieve all WhatsApp templates associated with your business account. Templates with the same name but different language translations are grouped together as a **template group**. Use this endpoint to check approval status after submitting a new template.

## Endpoint

```text theme={null}
POST https://api.connectly.ai/v1/businesses/{businessId}/get/templates
```

This endpoint uses POST with no request body.

## Response

Returns a list of template groups under `entity.templateGroups`. Each group contains one or more language variants.

**Template status values:**

| Status                             | Description                                            |
| ---------------------------------- | ------------------------------------------------------ |
| `MESSAGE_TEMPLATE_STATUS_PENDING`  | Submitted to Meta and awaiting review.                 |
| `MESSAGE_TEMPLATE_STATUS_APPROVED` | Approved by Meta — ready to use.                       |
| `MESSAGE_TEMPLATE_STATUS_REJECTED` | Rejected by Meta. Check `rejectionReason` for details. |

## Example

```bash theme={null}
curl -X POST "https://api.connectly.ai/v1/businesses/{businessId}/get/templates" \
  -H "X-API-Key: YOUR_API_KEY"
```

```json theme={null}
{
  "entity": {
    "templateGroups": [
      {
        "id": "order_confirmation",
        "name": "order_confirmation",
        "category": "ACCOUNT_UPDATE",
        "templates": [
          {
            "id": "651213231234567",
            "language": { "code": "en" },
            "status": "MESSAGE_TEMPLATE_STATUS_REJECTED",
            "createdAt": "2022-03-09T23:07:01Z",
            "updatedAt": "2022-03-09T23:07:01Z",
            "rejectionReason": "INVALID_FORMAT",
            "templateComponents": [
              {
                "header": {
                  "media": {
                    "type": "TYPE_IMAGE",
                    "example": ["https://example.com/header.png"]
                  }
                }
              },
              {
                "body": {
                  "text": {
                    "text": "Welcome to Connectly!",
                    "example": []
                  }
                }
              },
              {
                "footer": {
                  "text": { "text": "Connectly.ai", "example": [] }
                }
              },
              { "button": { "quickReply": { "text": "Continue" } } },
              { "button": { "quickReply": { "text": "Stop" } } }
            ],
            "externalTemplate": {
              "whatsapp": {
                "id": "651213231234567",
                "name": "order_confirmation",
                "language": "en",
                "status": "REJECTED",
                "rejectedReason": "INVALID_FORMAT",
                "qualityScore": { "score": "UNKNOWN" }
              }
            }
          }
        ]
      }
    ]
  }
}
```

<Note>
  The `externalTemplate.whatsapp` object contains the raw template data as returned directly by Meta, alongside Connectly's own representation in `templateComponents`. Use `templateComponents` for the Connectly-native format.
</Note>