Agentconversations

Conversation stats

Aggregated counts and averages over the caller's conversations, scoped by the same filters as the list endpoint.

Authentication

AuthorizationBearer

Enter your API key with the Bearer prefix, e.g. ‘Bearer sk_…’.

Query parameters

agent_idstringOptional
Filter to conversations for this agent.
statusenumOptional
Filter by conversation status.
Allowed values:
transportenumOptional
Filter by transport.
Allowed values:
caller_identitystringOptional
Filter by caller identity.
searchstringOptional

Free-text search across conversation content.

started_afterdatetimeOptional
Only conversations started at or after this RFC 3339 timestamp.
started_beforedatetimeOptional
Only conversations started at or before this RFC 3339 timestamp.
duration_min_msintegerOptional
Minimum conversation duration in milliseconds.
duration_max_msintegerOptional
Maximum conversation duration in milliseconds.

Response

Stats for the matched conversations.
totallong
completedlong
failedlong
activelong
pendinglong
avg_duration_msdouble or null
avg_cost_centsdouble or null

Errors

401
Unauthorized Error