Dashboard Summary
Retrieve aggregated dashboard metrics.
GET /reports/dashboard
Authentication: JWT cookie or API key
| Parameter | Type | Default | Description |
|---|
start_date | string | 7 days ago | ISO 8601 start date |
end_date | string | now | ISO 8601 end date |
agent_id | string | — | Filter by agent |
call_type | string | — | “phone” or “web” |
interval | string | auto | Time bucketing: “hour”, “day”, “week”, “month” |
curl -X GET "https://api.vaani.ai/reports/dashboard?start_date=2026-02-01&end_date=2026-02-11&interval=day" \
-H "Cookie: access_token=YOUR_TOKEN"
Call Summary Report
Retrieve detailed call metrics with selectable fields.
GET /reports/call-summary
| Parameter | Type | Description |
|---|
fields | string | Comma-separated metric names |
start_date | string | ISO 8601 start date |
end_date | string | ISO 8601 end date |
agent_id | string | Filter by agent |
total_calls, total_duration, avg_duration, total_cost, cost_llm, cost_stt, cost_tts, platform_cost, total_tokens, avg_tokens
curl -X GET "https://api.vaani.ai/reports/call-summary?fields=total_calls,total_cost,avg_duration&start_date=2026-02-01" \
-H "Cookie: access_token=YOUR_TOKEN"
Disposition Summary
Analyze call outcomes by disposition type.
GET /reports/disposition
curl -X GET "https://api.vaani.ai/reports/disposition?start_date=2026-02-01" \
-H "Cookie: access_token=YOUR_TOKEN"
Agent Workload (Prometheus)
Retrieve real-time agent worker metrics.
GET /reports/workload
curl -X GET "https://api.vaani.ai/reports/workload" \
-H "Cookie: access_token=YOUR_TOKEN"
Workload data is read directly from the agent worker’s Prometheus metrics endpoint and parsed by the backend.
