List Campaigns

Returns a paginated list of campaigns scoped to your organization, with summary counters (sent / delivered / read / failed / replies) attached to each row.

GET/v2.0/campaigns

Query Parameters

Query

ParameterTypeDescription
statusstringFilter: draft | scheduled | processing | completed | failed | paused | cancelled
brandNumberstringFilter to campaigns sent from this WhatsApp Business number
pagenumber1-based page indexDefault: 1
limitnumberPage size (1–100)Default: 20

Example

curl -X GET "https://api.sendiee.com/v2.0/campaigns?status=completed&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "success": true,
  "data": [
    {
      "campaignId": "664a0bcd...",
      "name": "Diwali sale 2026",
      "templateName": "diwali_sale_2026",
      "status": "completed",
      "scheduleType": "immediate",
      "scheduledAt": null,
      "timezone": "UTC",
      "totals": {
        "totalContacts": 1234,
        "processed": 1234,
        "sent": 1200,
        "failed": 30,
        "delivered": 1180,
        "read": 950,
        "replies": 78
      },
      "startedAt": "2026-04-29T05:00:00.000Z",
      "completedAt": "2026-04-29T05:18:42.000Z",
      "createdAt": "2026-04-29T04:55:00.000Z"
    }
  ],
  "pagination": {
    "total": 42,
    "page": 1,
    "limit": 10,
    "totalPages": 5,
    "hasMore": true
  }
}