Skip to main content
GET
Returns project-level voice conversation analytics: totals, average duration, and daily conversation/duration maps. Non-voice projects may return empty metrics.

Authentication

X-API-Key
string
required
Project API key for this organization and project. Format: bot_live_…

Path parameters

organization_id
string
required
Organization ID. Must match the API key.
project_id
string
required
Project ID. Must match the API key.

Query parameters

filters
string
JSON MongoDB-compatible filter object. Example: {"status":"completed","start_time":{"$gte":"2026-07-01T00:00:00Z","$lte":"2026-07-22T23:59:59Z"}}.
skip
integer
default:"0"
Accepted for compatibility. Aggregation returns summary series (not a paged conversation list).
limit
integer
default:"20"
Accepted for compatibility (11000). Not applied to the summary aggregation.
sort
string
Accepted for compatibility. Not applied to the summary aggregation.

Response

summary
object
required
Aggregate totals for the filtered conversations.
daily_conversations
object
required
Map of date bucket key → conversation count.
daily_durations
object
required
Map of date bucket key → total duration seconds.

Errors

400
Bad Request
Invalid organization or project id.
401
Unauthorized
Missing, invalid, or revoked API key.
403
Forbidden
API key is not authorized for this organization or project.
404
Not Found
Project not found.