Skip to main content
GET
List Conversations

Path Parameters

agent_id
string
required

Query Parameters

limit
integer | null

Maximum conversations to return. Sending this switches the response to the paged object shape.

Required range: x >= 1
cursor
integer | null

Where to resume from: the next_cursor of the previous page. Sending this switches the response to the paged object shape.

Required range: x >= 0
since
number | null

Only 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.

until
number | null

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.

status
string | null

Only conversations with this status: complete, screened_out, failed, or in_progress.

source
string | null

Only conversations from this source (e.g. twilio, exotel).

include_transcript
boolean
default:false

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

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.

conversation_id
string
required
filled_fields
integer
required
form_data
Form Data · object
required
form_status
Form Status · object
required
has_events
boolean
required
has_log
boolean
required
has_metrics
boolean
required
has_recording
boolean
required
is_ended
boolean
required
status
enum<string>
required
Available options:
complete,
screened_out,
failed,
in_progress
total_fields
integer
required
caller_number
string | null
created_at
number | null
has_transcript
boolean | null
source
string | null
transcript
Transcript · object[] | null