> ## Documentation Index
> Fetch the complete documentation index at: https://developers.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a campaign's statistics

> Returns the campaign's aggregated performance on one of two bases, told apart by `range` in the response:

- **All-time** (no `dateFrom`/`dateTo`): lifetime counters served from a projection refreshed in the background — `updated_at` tells you how fresh they are, and `range` is null. `call_durations` is included only when `includeDurations=true` (it is the one read whose cost grows with the campaign).
- **Ranged** (`dateFrom` and `dateTo` both set): counters aggregated at request time over the half-open window `[dateFrom, dateTo)`. `range` echoes the resolved window, `updated_at` is null, and durations are always included (`includeDurations` is ignored).

A date-only `dateTo` (`YYYY-MM-DD`) names a calendar day and is served inclusive of it — the exclusive end moves to the following UTC midnight, so equal date-only bounds are a valid one-day window. There is no limit on the window's length; the only bound is the 13-month event retention horizon on `dateFrom`. Supplying only one bound, an empty window, or a `dateFrom` past the horizon is a 422.

The membership-state blocks (`contact_states*`, `pending_by_category`, `open_assignments`) always describe the campaign's current state — a window does not narrow them. Unknown query parameters are rejected with 400 rather than ignored. A campaign that has never been dialed returns zeroed counters, not 404.

<Warning>The Dialer is a newly released product surface: depending on your account's rollout stage, campaigns managed through this API may not yet be visible in your CloudTalk Dashboard.</Warning>


## API Specification

The full API specification for this endpoint is available in the [documentation index](https://developers.cloudtalk.io/llms.txt).


## Related topics

- [Get a dialer campaign](/api-reference/dialer/get-a-dialer-campaign.md)
- [Get a campaign's associations](/api-reference/dialer/get-a-campaigns-associations.md)
- [Get one campaign contact](/api-reference/dialer/get-one-campaign-contact.md)