5a5597ebb2d6

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-126178842.7 MB
conversations

List v2 conversations

get/v1/conversations

Query parameters

statusstring nullable
channelstring nullable
end_user_idstring uuid nullable
assigned_agent_idstring uuid nullable
prioritystring nullable
started_afterstring date-time nullable

Lower-bound (inclusive) on conversation started_at.

Lower-bound (inclusive) on conversation started_at.

started_beforestring date-time nullable

Upper-bound (inclusive) on conversation started_at.

Upper-bound (inclusive) on conversation started_at.

qstring nullable

Case-insensitive substring match on subject/summary.

Case-insensitive substring match on subject/summary.

eval_filter'has_evals' | 'no_evals' | 'all_passed' | 'any_failed' nullable
from_numberstring nullable

Originating phone number, matched as normalized E.164. On an inbound session this is the customer's caller ID; on an outbound one it is the platform number that dialed. Applies to voice and SMS.

Originating phone number, matched as normalized E.164. On an inbound session this is the customer's caller ID; on an outbound one it is the platform number that dialed. Applies to voice and SMS.

to_numberstring nullable

Destination phone number, matched as normalized E.164. On an inbound session this is the platform number that was dialed; on an outbound one it is the customer's number. Applies to voice and SMS.

Destination phone number, matched as normalized E.164. On an inbound session this is the platform number that was dialed; on an outbound one it is the customer's number. Applies to voice and SMS.

emailstring nullable

Sessions whose end user owns this email address (case-insensitive).

Sessions whose end user owns this email address (case-insensitive).

idstring uuid nullable

Exact-match lookup by session id.

Exact-match lookup by session id.

external_session_idstring nullable

Exact-match lookup by the caller-supplied external session id.

Exact-match lookup by the caller-supplied external session id.

limitinteger
cursorstring nullable

Response

Successful Response

next_cursorstring nullable
has_moreboolean required