Skip to main content
GET
/
v1
/
reports
/
minutes-by-organization
curl "https://api.telzino.com/v1/reports/minutes-by-organization?start_date=2026-04-01&end_date=2026-04-30" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# Filter by specific organizations
curl "https://api.telzino.com/v1/reports/minutes-by-organization?start_date=2026-04-01&end_date=2026-04-30&organization_ids=123e4567-e89b-12d3-a456-426614174000,223e4567-e89b-12d3-a456-426614174001" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# Filter by reseller
curl "https://api.telzino.com/v1/reports/minutes-by-organization?start_date=2026-04-01&end_date=2026-04-30&reseller_ids=323e4567-e89b-12d3-a456-426614174999" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "data": [
    {
      "organization_id": "123e4567-e89b-12d3-a456-426614174000",
      "organization_name": "Acme Solar",
      "reseller_id": "323e4567-e89b-12d3-a456-426614174999",
      "reseller_name": "Acme Partners",
      "total_voice_minutes": 512.7,
      "agent_count": 2,
      "agents": [
        {
          "agent_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "agent_name": "Customer Support Agent",
          "voice_minutes": 370.4
        },
        {
          "agent_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
          "agent_name": "Booking Agent",
          "voice_minutes": 142.3
        }
      ]
    }
  ],
  "period": {
    "start_date": "2026-04-01",
    "end_date": "2026-04-30"
  }
}

​
Overview

Returns voice minutes aggregated per organization for the requested date range, including a nested per-agent breakdown. If neither organization_ids nor reseller_ids is provided, all organizations the caller has access to are returned.

​
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)
​
organization_ids
string | string[]
Optional filter by organization UUIDs. Provide either:
  • A comma-separated list: organization_ids=uuid1,uuid2
  • Or repeated bracketed params: organization_ids[]=uuid1&organization_ids[]=uuid2
​
reseller_ids
string | string[]
Optional filter by reseller UUIDs. Same formats as organization_ids. Combined with organization_ids, both filters are applied.
curl "https://api.telzino.com/v1/reports/minutes-by-organization?start_date=2026-04-01&end_date=2026-04-30" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# Filter by specific organizations
curl "https://api.telzino.com/v1/reports/minutes-by-organization?start_date=2026-04-01&end_date=2026-04-30&organization_ids=123e4567-e89b-12d3-a456-426614174000,223e4567-e89b-12d3-a456-426614174001" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# Filter by reseller
curl "https://api.telzino.com/v1/reports/minutes-by-organization?start_date=2026-04-01&end_date=2026-04-30&reseller_ids=323e4567-e89b-12d3-a456-426614174999" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "data": [
    {
      "organization_id": "123e4567-e89b-12d3-a456-426614174000",
      "organization_name": "Acme Solar",
      "reseller_id": "323e4567-e89b-12d3-a456-426614174999",
      "reseller_name": "Acme Partners",
      "total_voice_minutes": 512.7,
      "agent_count": 2,
      "agents": [
        {
          "agent_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "agent_name": "Customer Support Agent",
          "voice_minutes": 370.4
        },
        {
          "agent_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
          "agent_name": "Booking Agent",
          "voice_minutes": 142.3
        }
      ]
    }
  ],
  "period": {
    "start_date": "2026-04-01",
    "end_date": "2026-04-30"
  }
}
When a caller has no resellers, when the reseller_ids filter excludes all accessible resellers, or when no organizations match the filters, the endpoint returns 200 with an empty data array.

​
Response Fields

​
data

Array of per-organization usage entries:
FieldTypeDescription
organization_idstring (UUID)Organization ID
organization_namestringOrganization name (falls back to internal ID if unset)
reseller_idstring (UUID)Reseller that owns the organization
reseller_namestringReseller name (falls back to internal ID if unset)
total_voice_minutesnumberTotal voice minutes for the organization in the range
agent_countnumberNumber of agents under this organization
agentsarrayPer-agent breakdown, sorted by voice_minutes descending

​
agents[]

FieldTypeDescription
agent_idstring (UUID)Agent ID
agent_namestringAgent name (falls back to external_id or internal ID if unset)
voice_minutesnumberVoice minutes for this agent in the range

​
period

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