List conversations
Returns conversations for your organization, newest first, as a plain JSON array.
Pagination. Results are cursor-based and walk backwards in time. Take the created_at of the last item, Base64-encode that timestamp, and pass it as cursor to fetch older conversations. Stop when a page returns fewer than limit items.
Field visibility depends on your token’s role — read-only tokens receive a reduced set of fields. Requires a token with read access.
Headers
Organization ID for user PATs (pat_ prefix tokens)
Query Parameters
Filter by direction.
Filter by user ID (partial match).
Filter by agent phone number (partial match).
Filter by agent ID.
Filter by agent version ID.
Filter by web widget ID.
Filter by channel.
Only conversations lasting at least this many seconds.
Only conversations lasting at most this many seconds.
Only conversations with at least this many user turns.
Only conversations with at most this many user turns.
Match against attached metadata. Must be a JSON object string, e.g. {"order_id":"123"}.
Filter by status.
Conversations created on or after this time.
Conversations created on or before this time.
Conversations updated on or after this time.
Conversations updated on or before this time.
Maximum number of conversations to return.
Base64-encoded pagination cursor (the ISO 8601 created_at of the last item from the previous page).
Comma-separated list of fields to return, e.g. id,status,created_at.
Response
Successful Response
Direction of the conversation.
inbound, outbound Top-level agent configuration.
Channel type for the conversation.
telephone, webrtc, email, text Status of the conversation.
token_created, triggered, ringing, in_progress, completed, failed, cancelled, transferred, unanswered Agent reference with id and name.

