Analytics
Overview
The analytics endpoints provide per-user call metrics scoped to the authenticated API key owner. Use them to monitor call volume, duration, and status breakdowns across assistants, phone numbers, time periods, and telephony services.
All analytics data is derived from the CallRecord collection and filtered by the caller's created_by_email.
Authentication
All analytics endpoints require a valid API key passed as a Bearer token:
Common Query Parameters
Every analytics endpoint accepts optional date-range filters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
start_date |
datetime | No | 30 days ago | ISO 8601 start of range. |
end_date |
datetime | No | Now | ISO 8601 end of range. |
Available Endpoints
| Endpoint | Description |
|---|---|
| Dashboard | At-a-glance totals: calls, duration, status breakdown, period counts. |
| By Assistant | Per-assistant call count and duration. |
| By Phone Number | Per destination number breakdown. |
| By Time | Time-series data with day, week, or month granularity. |
| By Service | Breakdown by telephony service (exotel, twilio, web). |
Data scoping
Results are always scoped to the authenticated user. To see cross-tenant data, use the Admin endpoints with a super-admin API key.