---
title: "List approved WhatsApp templates"
method: GET
path: "/api/channels/{id}/templates"
tags: ["Channels"]
---

# List approved WhatsApp templates

`GET /api/channels/{id}/templates`

## Request

- Base URL: `https://api.setluca.com`
- URL: `https://api.setluca.com/api/channels/{id}/templates`
- Auth: API key in cookie `luca.session_token`

The WhatsApp message templates Meta has approved for this account. Outside the 24-hour customer service window, an approved template is the only thing WhatsApp will deliver.

**Session-only.** This endpoint isn't on the API-key allowlist. An organization API key gets a 403 here, whatever scopes it holds.

## Path parameters

- `id` string, uuid, required

## Headers

- `Luca-API-Version` '1'

## Response `200`

ok

- WhatsAppTemplatesResponse
  - `templates` object[], required
    - `id` string, uuid, required
    - `name` string, required
    - `body` string, required
    - `language` string, required
    - `category` string, required
    - `status` 'approved', required
    - `versionHash` string, required
    - `components` unknown[], required
      - unknown
    - `parameterRequirements` union[], required
      - union
        - object
          - `key` string, required
          - `component` 'header' | 'body' | 'button', required
          - `index` integer, required
          - `parameterName` string
          - `buttonIndex` integer
          - `buttonSubtype` 'url' | 'copy_code' | 'flow'
          - `kind` 'text', required
        - object
          - `key` string, required
          - `component` 'header', required
          - `index` integer, required
          - `parameterName` string
          - `buttonIndex` integer
          - `buttonSubtype` 'url' | 'copy_code' | 'flow'
          - `kind` 'image' | 'video' | 'document', required
    - `syncedAt` string, required
  - `billingNotice` 'Meta bills WhatsApp messages to your WhatsApp Business Account. Luca does not calculate or add provider charges.', required

## Other responses

- `400`: bad request
- `401`: unauthorized
- `404`: not found
- `409`: conflict
- `429`: rate limited
- `500`: internal error
- `501`: not implemented
- `502`: upstream failure
- `503`: service unavailable

---

[API](https://skmtc.dev/setluca/apis/luca-api.md) · [All operations](https://skmtc.dev/setluca/apis/luca-api/llms.txt) · [OpenAPI document](https://skmtc.dev/setluca/apis/luca-api/revisions/90a200e4100b?raw)