---
title: "Team metrics"
method: POST
path: "/v2/api/analytics/overview"
tags: ["Analytics"]
---

# Team metrics

`POST /v2/api/analytics/overview`

Returns team-wide KPIs with period-over-period comparison and a per-user breakdown. Covers all calls (inbound + outbound).

## Request body

- AnalyticsBaseRequest
  - `date` AnalyticsDateRange, required
    - `from` string, date, required — Start date
    - `to` string, date, required — End date
  - `compare_date` AnalyticsDateRange
    - `from` string, date, required — Start date
    - `to` string, date, required — End date
  - `user_ids` string[] — Filter by user IDs. Cannot be combined with allo_numbers.
  - `allo_numbers` string[] — Filter by Allo numbers (E.164). Cannot be combined with user_ids.

## Response `200`

Team summary

- object
  - `data` object
    - `date` AnalyticsDateRange
      - `from` string, date, required — Start date
      - `to` string, date, required — End date
    - `compare_date` AnalyticsDateRange
      - `from` string, date, required — Start date
      - `to` string, date, required — End date
    - `summary` object
      - `total_calls` MetricValue
        - `value` number — Current period value
        - `previous` number, nullable — Previous period value
        - `change` number, nullable — Percentage change vs previous period (e.g. 0.15 = +15%)
      - `talk_time_seconds` MetricValue
        - `value` number — Current period value
        - `previous` number, nullable — Previous period value
        - `change` number, nullable — Percentage change vs previous period (e.g. 0.15 = +15%)
      - `calls_over_1_min` MetricValue
        - `value` number — Current period value
        - `previous` number, nullable — Previous period value
        - `change` number, nullable — Percentage change vs previous period (e.g. 0.15 = +15%)
      - `answer_rate` MetricValue
        - `value` number — Current period value
        - `previous` number, nullable — Previous period value
        - `change` number, nullable — Percentage change vs previous period (e.g. 0.15 = +15%)
    - `breakdown` UserBreakdown[]
      - `user` UserRef
        - `id` string
        - `name` string
        - `email` string
      - `calls` MetricValue
        - `value` number — Current period value
        - `previous` number, nullable — Previous period value
        - `change` number, nullable — Percentage change vs previous period (e.g. 0.15 = +15%)
      - `talk_time_seconds` MetricValue
        - `value` number — Current period value
        - `previous` number, nullable — Previous period value
        - `change` number, nullable — Percentage change vs previous period (e.g. 0.15 = +15%)
      - `calls_over_1_min` MetricValue
        - `value` number — Current period value
        - `previous` number, nullable — Previous period value
        - `change` number, nullable — Percentage change vs previous period (e.g. 0.15 = +15%)
      - `answer_rate` MetricValue
        - `value` number — Current period value
        - `previous` number, nullable — Previous period value
        - `change` number, nullable — Percentage change vs previous period (e.g. 0.15 = +15%)
    - `last_updated` string, date-time — When the metrics were last updated

## Other responses

- `400` — Invalid request parameters
- `401` — Invalid or missing API key
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/withallo/apis/allo-api.md) · [All operations](https://skmtc.dev/withallo/apis/allo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/withallo/allo-api/revisions/9aab4db82933/schema)