---
title: "Obtain Calls Statistics by filter summarized by period"
method: POST
path: "/{sub_domain}/api/calls-statistics"
tags: ["Calls-Statistics"]
---

# Obtain Calls Statistics by filter summarized by period

`POST /{sub_domain}/api/calls-statistics`

## Request

- Base URL: `https://api.commpeak.com/dialer`
- URL: `https://api.commpeak.com/dialer/{sub_domain}/api/calls-statistics`
- Auth: API key in header `Authorization`

Curated wrapper over `/api/cdrs/cdrs-aggregate`: forces yearly period and a fixed set of useful fields (total calls, successful calls, ACD, ASR, costs). Pass the human-readable groupings in `group_by` (semicolon-separated, e.g. "period;campaign"). For raw aggregation use `aggregate_cdrs` instead.

## Path parameters

- `sub_domain` string, required: Dialer Name (subdomain)

## Request body

- CallStatisticsRequestBody
  - `filter` CDRFilter, required
    - `start_at` string, required
    - `end_at` string, required
  - `group_by` string, required

## Response `200`

Successful Response

- CallStatisticsResponse
  - `result` CallStatistics[], required
    - `total calls` integer, required
    - `lead file` integer, required
    - `cost` integer, required
    - `support site` integer, required
    - `successful calls` integer, required
    - `purchase site` integer, required
    - `total duration` integer, required
    - `ASR` number, required
    - `ACD` number, required

## Other responses

- `404`: Not Found
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/commpeak/apis/commpeak-dialer-api.md) - [All operations](https://skmtc.dev/commpeak/apis/commpeak-dialer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/commpeak/apis/commpeak-dialer-api/revisions/18c5edc07544?raw)