conversations

List v2 conversations

Changed on
get/v1/conversations

Request

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.

started_beforestring date-time nullable

Upper-bound (inclusive) on conversation started_at.

qstring nullable

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.

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.

emailstring nullable

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

idstring uuid nullable

Exact-match lookup by session id.

external_session_idstring nullable

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

limitinteger
cursorstring nullable

Response

Successful Response

next_cursorstring nullable
has_moreboolean required

Changes