---
title: "Get Call Metrics Stats"
method: GET
path: "/calls/v1/stats/call-metrics"
tags: ["Calls"]
---

# Get Call Metrics Stats

`GET /calls/v1/stats/call-metrics`

Returns aggregated call metrics (TTS/LLM/STT latency, turns, barge-in, durations) for finished calls in a date range.

- Default (no `teamId`): returns stats for the requester's team.
- `teamId=all`: returns all-teams stats (super_admin only).
- Date range (`start` to `end`) must not exceed 31 days.

## Query parameters

- `start` string, date-time
- `end` string, date-time
- `teamId` string
- `assistantId` string
- `assistantIds` string[]

## Response `200`

Successful response

- CallMetricsStatsResponse
  - `message` string
  - `data` union
    - CallMetricsStats
      - `teamId` string, nullable
      - `totalCalls` integer
      - `totalCallDuration` number — Total call duration in milliseconds
      - `assistantCallDuration` number — Total assistant call duration in milliseconds
      - `avgCallDuration` number
      - `ttsStats` object
        - `totalRequests` number
        - `totalLatency` number
        - `avgLatency` number
        - `errors` number
        - `retries` number
        - `apiRequests` number
        - `cacheRequests` number
        - `apiLatencyTotal` number
        - `cacheLatencyTotal` number
        - `apiLatencyAvg` number
        - `cacheLatencyAvg` number
      - `llmStats` object
        - `responseCount` number
        - `responseLatencyTotal` number
        - `responseLatencyAvg` number
        - `errors` number
        - `hangups` number
        - `inputTokens` number
        - `outputTokens` number
        - `inputTokensAvg` number
        - `outputTokensAvg` number
      - `sttStats` object
        - `count` number
        - `latencyTotal` number
        - `latencyAvg` number
        - `errors` number
      - `turnsStats` object
        - `bargeInCount` number
        - `bargeInTimeAvg` number
        - `userTurns` number
        - `assistantTurns` number
        - `playedTurns` number
        - `interruptedTurns` number
        - `skippedTurns` number
    - CallMetricsStats[] — Returned when teamId=all (super_admin).
      - `teamId` string, nullable
      - `totalCalls` integer
      - `totalCallDuration` number — Total call duration in milliseconds
      - `assistantCallDuration` number — Total assistant call duration in milliseconds
      - `avgCallDuration` number
      - `ttsStats` object
        - `totalRequests` number
        - `totalLatency` number
        - `avgLatency` number
        - `errors` number
        - `retries` number
        - `apiRequests` number
        - `cacheRequests` number
        - `apiLatencyTotal` number
        - `cacheLatencyTotal` number
        - `apiLatencyAvg` number
        - `cacheLatencyAvg` number
      - `llmStats` object
        - `responseCount` number
        - `responseLatencyTotal` number
        - `responseLatencyAvg` number
        - `errors` number
        - `hangups` number
        - `inputTokens` number
        - `outputTokens` number
        - `inputTokensAvg` number
        - `outputTokensAvg` number
      - `sttStats` object
        - `count` number
        - `latencyTotal` number
        - `latencyAvg` number
        - `errors` number
      - `turnsStats` object
        - `bargeInCount` number
        - `bargeInTimeAvg` number
        - `userTurns` number
        - `assistantTurns` number
        - `playedTurns` number
        - `interruptedTurns` number
        - `skippedTurns` number

## Other responses

- `400` — Invalid request (missing team, invalid date range, or range longer than 31 days)
- `403` — Forbidden (requesting another team or teamId=all without super_admin)

---

[API](https://skmtc.net/interactly/apis/interactly-api.md) · [All operations](https://skmtc.net/interactly/apis/interactly-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interactly/interactly-api/versions/f39cdcb1f4e4/schema)