> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev.setoo.work/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List WhatsApp campaigns

> Retrieve a paginated list of WhatsApp campaigns

Returns all WhatsApp campaigns configured for the authenticated tenant.

### Query parameters

<ParamField query="page" type="integer" default="1">
  1-based page number.
</ParamField>

<ParamField query="pageSize" type="integer" default="15">
  Items per page (maximum 100).
</ParamField>

<CodeGroup>
  ```bash curl theme={null}
  curl -X GET "https://api.agentic-os.com/api/v1/whatsapp/campaigns?page=1&pageSize=15" \
    -H "Authorization: Bearer $AGENTIC_OS_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.agentic-os.com/api/v1/whatsapp/campaigns",
      headers={"Authorization": f"Bearer {API_KEY}"},
      params={"page": 1, "pageSize": 15},
  )
  print(response.json())
  ```

  ```javascript Node theme={null}
  const response = await fetch(
    "https://api.agentic-os.com/api/v1/whatsapp/campaigns?page=1&pageSize=15",
    {
      method: "GET",
      headers: { Authorization: `Bearer ${API_KEY}` },
    },
  );
  const data = await response.json();
  console.log(data);
  ```
</CodeGroup>

### Response

```json theme={null}
{
  "items": [
    {
      "id": "55555555-5555-5555-5555-555555555555",
      "tenantId": "990e8400-e29b-41d4-a716-446655440000",
      "agentId": "11111111-1111-1111-1111-111111111111",
      "name": "Post-Call Customer Follow-up",
      "phoneNumberId": "105938472910293",
      "isActive": true,
      "templates": [
        {
          "id": "template_1",
          "templateName": "call_summary_feedback",
          "languageCode": "en_US",
          "process": "OUTGOING",
          "callStatus": "ANSWERED"
        }
      ],
      "createdAt": "2026-06-01T11:00:00.000Z",
      "updatedAt": "2026-06-01T11:00:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 15
}
```