Skip to main content
GET
/
v1
/
reports
/
minutes-by-agent
curl "https://api.telzino.com/v1/reports/minutes-by-agent?start_date=2026-04-01&end_date=2026-04-30&agent_ids=123e4567-e89b-12d3-a456-426614174000,223e4567-e89b-12d3-a456-426614174001" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "data": [
    {
      "agent_id": "123e4567-e89b-12d3-a456-426614174000",
      "agent_name": "Customer Support Agent",
      "reseller_name": "Acme Partners",
      "total_minutes": 324.5,
      "call_count": 87
    },
    {
      "agent_id": "223e4567-e89b-12d3-a456-426614174001",
      "agent_name": "Booking Agent",
      "reseller_name": "Acme Partners",
      "total_minutes": 142.1,
      "call_count": 33
    }
  ],
  "period": {
    "start_date": "2026-04-01",
    "end_date": "2026-04-30"
  }
}

​
Overview

Returns per-agent voice minutes and call counts for the requested date range. Only agents owned by the authenticated account are returned; unknown or cross-account agent IDs are filtered out.

​
Query Parameters

​
start_date
string
required
Start of the date range in YYYY-MM-DD format (e.g., 2026-04-01)
​
end_date
string
required
End of the date range in YYYY-MM-DD format (e.g., 2026-04-30)
​
agent_ids
string | string[]
required
One or more agent UUIDs. Provide either:
  • A comma-separated list: agent_ids=uuid1,uuid2
  • Or repeated bracketed params: agent_ids[]=uuid1&agent_ids[]=uuid2
At least one agent UUID is required.
curl "https://api.telzino.com/v1/reports/minutes-by-agent?start_date=2026-04-01&end_date=2026-04-30&agent_ids=123e4567-e89b-12d3-a456-426614174000,223e4567-e89b-12d3-a456-426614174001" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "data": [
    {
      "agent_id": "123e4567-e89b-12d3-a456-426614174000",
      "agent_name": "Customer Support Agent",
      "reseller_name": "Acme Partners",
      "total_minutes": 324.5,
      "call_count": 87
    },
    {
      "agent_id": "223e4567-e89b-12d3-a456-426614174001",
      "agent_name": "Booking Agent",
      "reseller_name": "Acme Partners",
      "total_minutes": 142.1,
      "call_count": 33
    }
  ],
  "period": {
    "start_date": "2026-04-01",
    "end_date": "2026-04-30"
  }
}

​
Response Fields

​
data

Array of per-agent usage entries:
FieldTypeDescription
agent_idstring (UUID)Agent ID
agent_namestringAgent name (falls back to external_id or internal ID if unset)
reseller_namestringReseller that owns the agent’s organization, or - if unavailable
total_minutesnumberTotal voice minutes in the range
call_countnumberNumber of calls in the range

​
period

FieldTypeDescription
start_datestringEchoes the request’s start_date
end_datestringEchoes the request’s end_date