---
title: "List message templates"
method: GET
path: "/api/profiles/{profile_id}/templates"
tags: ["WhatsApp"]
---

# List message templates

`GET /api/profiles/{profile_id}/templates`

## Request

- Base URL: `https://api.postproxy.dev`
- URL: `https://api.postproxy.dev/api/profiles/{profile_id}/templates`
- Auth: HTTP bearer

Lists the message templates on the WhatsApp Business Account, ordered by name then language. Not paginated.

## Query parameters

- `profile_group_id` string
- `name` string
- `language` string
- `status` string
- `refresh` boolean

## Response `200`

Matching templates.

- WhatsAppTemplateListResponse: Every matching template, ordered by name then language. Not paginated.
  - `data` WhatsAppTemplate[]
    - `id` string: Postproxy hashid
    - `external_id` string, nullable: Meta’s template id
    - `profile_id` string
    - `name` string: Lowercase letters, digits and underscores, starting with a letter. With language it identifies the template on Meta.
    - `language` string: Meta language code, e.g. en_US, pt_BR, de
    - `category` 'UTILITY' | 'MARKETING' | 'AUTHENTICATION'
    - `status` 'APPROVED' | 'PENDING' | 'REJECTED' | 'PAUSED' | 'DISABLED' | 'IN_APPEAL' | 'PENDING_DELETION': Meta review status. Only APPROVED templates can be sent.
    - `parameter_format` 'POSITIONAL' | 'NAMED' | 'null', nullable
    - `components` object[]: Meta’s component array — HEADER, BODY, FOOTER, BUTTONS.
    - `message_send_ttl_seconds` integer: Time-to-live for undelivered sends, when the template overrides Meta’s default.
    - `rejected_reason` string: Present when Meta rejected the template.
    - `quality_score` object: Meta’s quality score once scored, e.g. { "score": "GREEN" }.
    - `variable_count` integer: How many variables a send of this template expects.
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `401`: Invalid, missing, or insufficient API key permissions.
- `404`: Resource does not exist or is not accessible.
- `422`: Validation failed.

---

[API](https://skmtc.dev/postproxy/apis/postproxy-social-media-api.md) - [All operations](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/llms.txt) - [OpenAPI document](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/revisions/d54482ac4ce7?raw)