> For the complete documentation index, see [llms.txt](https://heyguest-ai.gitbook.io/heyguest/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://heyguest-ai.gitbook.io/heyguest/reference/templates.md).

# Templates

List approved WhatsApp templates.

## List WhatsApp templates

> Returns all approved (and pending) templates under your team's WhatsApp Business Account.

```json
{"openapi":"3.0.3","info":{"title":"HeyGuest External API","version":"1.1.0"},"tags":[{"name":"Templates","description":"List approved WhatsApp templates."}],"servers":[{"url":"https://app.heyguest.ai/api/v1","description":"Production"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"Sanctum personal access token (team-scoped)"}},"schemas":{"Template":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"wa_id":{"type":"string","description":"Provider-side identifier (the template content reference)."},"name":{"type":"string"},"status":{"type":"string","description":"WhatsApp template status (e.g. `APPROVED`, `PENDING`, `REJECTED`)."},"category":{"type":"string"},"rejection_reason":{"type":"string","nullable":true},"header_type":{"type":"string","nullable":true},"header_content":{"type":"string","nullable":true},"header_image":{"type":"string","nullable":true},"facebook_media_handle":{"type":"string","nullable":true},"body":{"type":"string"},"footer":{"type":"string","nullable":true},"buttons":{"type":"array","nullable":true,"items":{"type":"object","additionalProperties":true}}}}}},"paths":{"/templates":{"get":{"tags":["Templates"],"summary":"List WhatsApp templates","description":"Returns all approved (and pending) templates under your team's WhatsApp Business Account.","operationId":"listTemplates","responses":{"200":{"description":"Templates.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Template"}}}}}}}}}}}}
```