# List WhatsApp campaigns

`GET https://api.chat-data.com/api/v2/whatsapp-campaigns`

Canonical: https://www.chat-data.com/api-reference/list-whatsapp-campaigns

## Authentication

Send an API key as a Bearer token: `Authorization: Bearer $CHAT_DATA_API_KEY`. Workspace keys reach every chatbot in the workspace; chatbot-scoped keys reach only their chatbot. Keep keys on the server.

## Description

Lists the chatbot's campaigns, newest first, 20 per page, with their counters.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| chatbotId | query | string | yes |  |
| status | query | string | no |  |
| search | query | string | no |  |
| page | query | integer | no |  |

## Example request

```bash
curl 'https://api.chat-data.com/api/v2/whatsapp-campaigns?chatbotId=6650f1c2a9e4b83d2c7a1f05' \
  -H "Authorization: Bearer $CHAT_DATA_API_KEY"
```

## Example response (200)

```json
{
  "status": "success",
  "campaigns": [
    {
      "id": "6650f1c2a9e4b83d2c7a1f3c",
      "name": "Jane Doe",
      "phoneNumberId": "6650f1c2a9e4b83d2c7a1f3c",
      "template": {
        "name": "Jane Doe",
        "language": "sample language",
        "category": "sample category"
      },
      "replyMode": "ai",
      "status": "draft",
      "pauseReason": "sample pause reason",
      "schedule": {
        "at": "2026-10-14T09:30:00.000Z",
        "timeZone": "sample time zone"
      },
      "recipients": 10,
      "exclusions": {
        "opted_out": 3,
        "us_marketing": 12
      },
      "stats": {
        "queued": 10,
        "sent": 10,
        "delivered": 10,
        "read": 10,
        "replied": 10,
        "formCompleted": 10,
        "failed": 10,
        "cancelled": 10
      },
      "startedAt": "2026-10-14T09:30:00.000Z",
      "completedAt": "2026-10-14T09:30:00.000Z",
      "createdAt": "2026-10-14T09:30:00.000Z"
    }
  ],
  "total": 10,
  "page": 10,
  "pageSize": 10
}
```

## Responses

| Status | Description |
| --- | --- |
| 200 | A page of campaigns. |
| 401 | Authentication failed. |