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

# List Templates

> List all approved WhatsApp message templates for your account.

## Request Headers

**Authorization** `string` *required*

Bearer token. Format: `Bearer nc_live_your_api_key`

## Response

**templates** `array`

Array of approved template objects.

**Template properties**

**id** `string`

Template ID in your Notvis account.

**name** `string`

Template name as registered with Meta.

**language** `string`

Language code (e.g., `en_US`, `hi`).

**category** `string`

`MARKETING`, `UTILITY`, or `AUTHENTICATION`.

**status** `string`

`APPROVED`.

**components** `array`

Template components (header, body, footer, buttons).

> [!NOTE]
>
> Only templates with status `APPROVED` are returned. Templates must be approved by Meta before they can be used to send messages.

```bash cURL theme={null}
curl https://api.notvis.com/v1/whatsapp/templates \
  -H "Authorization: Bearer nc_live_your_api_key"
```

```javascript Node.js theme={null}
const response = await fetch('https://api.notvis.com/v1/whatsapp/templates', {
  headers: { 'Authorization': 'Bearer nc_live_your_api_key' },
});
const { templates } = await response.json();
templates.forEach(t => console.log(t.name, t.language, t.status));
```

```python Python theme={null}
import requests

response = requests.get(
    'https://api.notvis.com/v1/whatsapp/templates',
    headers={'Authorization': 'Bearer nc_live_your_api_key'},
)
for t in response.json()['templates']:
    print(t['name'], t['language'])
```

```json 200 Success theme={null}
{
  "templates": [
    {
      "id": "ecef131d-bd47-4aac-9aa0-60204b265cac",
      "name": "order_confirmation",
      "language": "en_US",
      "category": "UTILITY",
      "status": "APPROVED",
      "components": [
        {
          "type": "BODY",
          "text": "Hi {{1}}, your order {{2}} has been confirmed. Expected delivery: {{3}}."
        }
      ]
    },
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "hello_world",
      "language": "en_US",
      "category": "UTILITY",
      "status": "APPROVED",
      "components": [
        {
          "type": "BODY",
          "text": "Hello World"
        }
      ]
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.