Usage & Analytics

Query usage metrics, call counts, and billing analytics

Endpoints

Method	Path	Description
GET	`/organizations/usage/current-period`	Current billing period summary
GET	`/organizations/usage/runs`	Paginated list of all call sessions across all agents
GET	`/organizations/usage/runs/report`	Exportable CSV of all runs
GET	`/organizations/usage/daily-breakdown`	Per-day stats for N days
GET	`/organizations/usage/by-model`	LLM token usage broken down by model

Current Period

GET

/organizations/usage/current-period

Response

json

{
  "period_start": "2026-06-01T00:00:00Z",
  "period_end": "2026-06-30T23:59:59Z",
  "total_calls": 124,
  "total_minutes": 341,
  "total_cost_cents": 3069,
  "minutes_remaining": 96,
  "balance_cents": 864
}

All Call Sessions

GET

/organizations/usage/runs

Query Parameters

Parameter	Type	Required	Description
`limit`	integer	Optional	Max results per page (max 200)
`offset`	integer	Optional	Pagination offset
`from_date`	datetime	Optional	ISO 8601 start filter
`to_date`	datetime	Optional	ISO 8601 end filter
`workflow_id`	integer	Optional	Filter to a specific agent

Export Usage as CSV

GET

/organizations/usage/runs/report

Returns a downloadable CSV with all call sessions: agent name, duration, cost, outcome, and extracted data fields.

Daily Breakdown

GET

/organizations/usage/daily-breakdown

Query Parameters

Parameter	Type	Required	Description
`days`	integer	Optional	Days to include. Default: 30

Response: array with one entry per day — date, call_count, total_minutes, total_cost_cents.

Usage by Model

GET

/organizations/usage/by-model

Returns LLM token usage and estimated cost broken down by provider and model.

Was this page helpful?

PreviousVoices & Users NextTelemetry