# List Available Message Templates

Retrieve a list of messages within a specific date range. Supports filtering by from/to dates.

### <mark style="color:green;">`GET`</mark> `/message-templates`&#x20;

#### Required Permission

```
read:MessageTemplates
```

Your API key must have this permission enabled in order to use this endpoint.

#### Example Request

```bash
curl --location 'https://<hostname>/message-templates' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

Replace `YOUR_API_KEY` with your API key.

{% hint style="info" %}
All endpoints shown in this documentation use a **sample base URL**. The production API endpoint is provided by our team upon request.
{% endhint %}

#### Response (HTTP 200)

```json
{
  "success": true,
  "records": [
    {
      "id": "aaaaaaa-bbbbbbbb-cccccc-ddddddd-eee",
      "name": "Welcome Template",
      "text": "Hello {{NAME}}, welcome to our service!",
      "created_on": "2025-01-01T12:00:00.000Z"
    }
  ]
}
```

{% hint style="info" %}
We recommend using date filters to efficiently retrieve historical messages and campaign data.
{% endhint %}