# Batch query multiple message statuses
URL: /docs/api-reference/transactional-sms/queryMessageStatuses

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

**Summary:** Batch query multiple message statuses
**Operation ID:** `queryMessageStatuses`

Retrieves current delivery states and carrier timestamps for an array of up to 50 message IDs in a single call.

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

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

```json
{
  "type": "object",
  "required": [
    "messageIds"
  ],
  "properties": {
    "messageIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 50,
      "example": [
        "c7a8b9e0-1234-5678-9abc-def012345678",
        "e8f9a0b1-2345-6789-0bcd-ef0123456789"
      ]
    }
  }
}
```

### Responses

- **`200`**: Array of message details matching the requested IDs

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