GET/v1/reports/distribution/by-did

Distribution grouped by DID with nested calls

One object per DID bucket: aggregate KPIs for the full filter window, keyed by **did** (`group` / `name` from legacy grouped metrics). Bucket-level `queue_name` / `queue_number` are **null** (DID 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-did`.

Parameters 9

Name	Type	Description
from_daterequired	query · string	Start date (DD-MM-YYYY).
to_daterequired	query · string	End date (DD-MM-YYYY).
from_time	query · string	Start 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": {}
}

Try ItBevatel Developer APIs v1.0.0

Code examples

curl -H 'Authorization: Bearer <TOKEN>' '/v1/reports/distribution/by-did'

fetch("/v1/reports/distribution/by-did", {
  method: "GET",
  headers: {
      "Authorization": "Bearer <TOKEN>"
    },
})
  .then((response) => response.json())
  .then((data) => console.log(data))

import requests

url = "/v1/reports/distribution/by-did"
headers = {
    "Authorization": "Bearer <TOKEN>"
}

response = requests.get(url, headers=headers)
print(response.json())

Authentication

Authentication

Bearer token

Paste cURL