Conversation stats | SpeechifyAI API

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.

qstringOptional

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 headers

X-Request-IDstring

Unique identifier for this request, present on every response (2xx and non-2xx alike). If the caller sends an X-Request-ID request header the server echoes it back (sanitized and length-capped) so one logical request can be traced end-to-end; otherwise the server generates a fresh value. Log it on every response and quote it in support requests - it is the stable handle that ties your observation to Speechify’s server-side logs, and it matches the request_id field in the error envelope.

Unique identifier for this request, present on every response (2xx and non-2xx alike). If the caller sends an `X-Request-ID` request header the server echoes it back (sanitized and length-capped) so one logical request can be traced end-to-end; otherwise the server generates a fresh value. Log it on every response and quote it in support requests - it is the stable handle that ties your observation to Speechify's server-side logs, and it matches the `request_id` field in the error envelope.

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

1	{
2	"total": 10,
3	"completed": 7,
4	"failed": 1,
5	"active": 1,
6	"pending": 1,
7	"avg_duration_ms": 1,
8	"avg_cost_cents": 1
9	}