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

# GET /v1/templates — List Templates

> Retrieve all WhatsApp message templates registered in your RelayOS project, including their approval status and language configurations.

Use this endpoint to fetch all templates registered in your project. The response includes each template's current approval status, which you can use to determine whether a template is ready for sending.

## Request

**`GET https://api.relayos.com.br/v1/templates`**

This endpoint takes no request body or query parameters.

```bash theme={null}
curl https://api.relayos.com.br/v1/templates \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Response

A `200` response returns an array of template objects.

<ResponseField name="id" type="string">
  Unique template identifier.
</ResponseField>

<ResponseField name="name" type="string">
  Template slug name.
</ResponseField>

<ResponseField name="language" type="string">
  BCP-47 language code for the template (e.g., `pt_BR`, `en_US`).
</ResponseField>

<ResponseField name="status" type="string">
  Meta approval status. Possible values: `PENDING`, `APPROVED`, `REJECTED`.
</ResponseField>

```json theme={null}
[
  {
    "id": "tpl_01hwxyz123abc",
    "name": "order_confirmation",
    "language": "pt_BR",
    "status": "APPROVED"
  },
  {
    "id": "tpl_01hwxyz456def",
    "name": "welcome_message",
    "language": "en_US",
    "status": "PENDING"
  },
  {
    "id": "tpl_01hwxyz789ghi",
    "name": "promo_summer",
    "language": "pt_BR",
    "status": "REJECTED"
  }
]
```

<Info>
  Only templates with status `APPROVED` can be used in `POST /v1/messages`. Attempting to send with a `PENDING` or `REJECTED` template will return a `422` error.
</Info>