# List upcoming scheduled messages
URL: /docs/api-reference/bulk-campaign-messaging/listScheduledMessages

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

**Summary:** List upcoming scheduled messages
**Operation ID:** `listScheduledMessages`

Retrieves pending messages scheduled to be dispatched at a future timestamp.

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

### Responses

- **`200`**: List of pending scheduled messages

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