# List SMS campaigns
URL: /docs/api-reference/bulk-campaign-messaging/listCampaigns

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

**Summary:** List SMS campaigns
**Operation ID:** `listCampaigns`

Retrieves high-level campaign summaries with recipient totals and completion percentages.

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

### Responses

- **`200`**: List of active and historical campaigns

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