# List campaigns with live counts

> GET /campaigns. HeyRik API parameters and documented request and response examples.

Source: https://www.heyrik.com/docs/api-reference/campaigns/get-campaigns-list-campaigns-with-live-counts

GET https://server.heyrik.com/api/v1/campaigns

## Headers

Authorization: Bearer $HEYRIK_API_KEY (required). Keep your key on your server.

## Parameters

- agency_id (string): Only campaigns run by this agent.

## Notes

status is one of draft, scheduled, running, paused, completed, cancelled. completed is not final — pushing new leads reopens the campaign.

## Request example

```sh
curl https://server.heyrik.com/api/v1/campaigns \
  -H "Authorization: Bearer $HEYRIK_API_KEY"
```

## Response example

```json
{
  "data": [
    {
      "id": "cmp_4a19",
      "name": "July outreach",
      "status": "running",
      "agency_id": "agc_9f2a1c30",
      "total": 250,
      "counts": { "pending": 132, "calling": 1, "completed": 108, "failed": 9, "retry": 0, "total": 250 }
    }
  ]
}
```