List Conversations
Path Parameters
Query Parameters
Maximum conversations to return. Sending this switches the response to the paged object shape.
x >= 1Where to resume from: the next_cursor of the previous page. Sending this switches the response to the paged object shape.
x >= 0Only conversations created at or after this unix timestamp. Note: created_at is the last time the call's answers were written, not when the call happened, so a call edited later moves.
Only conversations created at or before this unix timestamp. Note: created_at is the last time the call's answers were written, not when the call happened, so a call edited later moves.
Only conversations with this status: complete, screened_out, failed, or in_progress.
Only conversations from this source (e.g. twilio, exotel).
Set true to include each call's transcript in its row. Off by default, because reading a transcript file for every call is what made this list slow; the transcript and has_transcript keys are then absent, not empty.
Response
Successful Response
- ConversationSummary · object[]
- ConversationPage · object
One row of the per-agent conversation list.
transcript and has_transcript are both absent unless the request
passed include_transcript=true.
has_recording, has_events, has_log and has_metrics say
whether the call has ended rather than checking for each file: those files
are only finalized at the end of a call, and checking every one of them for
every call is what made this list slow. The per-conversation routes still
answer 404 when a specific file genuinely is not there.
The cost, duration and latency figures are deliberately not here for the
same reason. They are on the cross-agent GET /conversations listing and
in the analytics numbers.
complete, screened_out, failed, in_progress