Skip to main content
GET

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

string
required
Start of the date range in YYYY-MM-DD format (e.g., 2026-04-01)
string
required
End of the date range in YYYY-MM-DD format (e.g., 2026-04-30)
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.

Response Fields

data

Array of per-agent usage entries:

period