# Query dispatch history (POST alias)
URL: /docs/api-reference/transactional-sms/getHistoryPost

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

**Summary:** Query dispatch history (POST alias)
**Operation ID:** `getHistoryPost`

Query dispatch history using a JSON body filter in environments where query string parameters are restricted.

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

### Request Body (`application/json`)

```json
{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "format": "date-time"
    },
    "to": {
      "type": "string",
      "format": "date-time"
    },
    "limit": {
      "type": "integer",
      "default": 50
    }
  }
}
```

### 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