Skip to content

GET/v1/reports/distribution/by-time

Distribution grouped by time period with nested calls

One object per time bucket: aggregate KPIs for the full filter window, keyed by **period** (`group` / `name` from legacy grouped metrics). Bucket-level `queue_name` / `queue_number` are **null** (temporal aggregates span queues). Nested **calls** are paginated globally across buckets (`page`, `per_page`, default 25, max 100). Each call row **includes** `queue_name` and `queue_number`. Call rows omit `recording` / `has_expired`. Time fields use **HH:MM:SS** strings. Empty **tags** is `{}`. Private upstream path: `/v1/reports/distribution/by-time`.

Parameters 10

NameTypeDescription
from_daterequiredquery · stringStart date (DD-MM-YYYY).
to_daterequiredquery · stringEnd date (DD-MM-YYYY).
from_timequery · stringStart time (HH-MM-SS). Defaults to start of day.

Bearer token required

Response examples

200OK

application/json example derived from schema

{
  "success_code": "OK",
  "message": "OK",
  "details": {},
  "meta": {
    "current_page": 0,
    "per_page": 0,
    "total": 0,
    "last_page": 0,
    "links": {
      "first": "string",
      "last": "string",
      "prev": "string",
      "next": "string"
    }
  }
}
400Bad Request

application/json example derived from schema

{
  "error_code": "VALIDATION_ERROR",
  "message": "string",
  "details": {}
}