# Query message dispatch history
URL: /docs/api-reference/transactional-sms/getHistory

## GET `/api/v1/public/sms/history`

**Summary:** Query message dispatch history
**Operation ID:** `getHistory`

Returns recent dispatched messages within an optional date-time range (up to 100 entries).

**Authentication:** `X-Api-Key: sk_live_...` or `Authorization: Bearer sk_live_...`

### Parameters

| Name | In | Required | Description |
| :--- | :--- | :--- | :--- |
| `from` | `query` | No | Filter messages dispatched on or after this timestamp |
| `to` | `query` | No | Filter messages dispatched on or before this timestamp |
| `limit` | `query` | No | Maximum number of records to return |

### Responses

- **`200`**: List of recent dispatched SMS records

```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "example": "success"
    },
    "data": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/SmsHistoryItemDto"
      }
    }
  }
}
```
- **`401`**: Authentication failed or API key missing