Agents
List agent conversations
Lists conversations for an agent, including the latest rolling summary and linked CRM contact. Supports full-text search (search), channel and feedback filters, and date ranges. Requires a USER API key.
get/public/v1/agents/{agentId}/conversations
Path parameters
agentIdstring required
Example:uuid-xxxx-xxxx
Query parameters
is_closed'true' | 'false'
Example:true
start_datestring nullable
Example:2026-01-01
end_datestring nullable
Example:2026-12-31
searchstring
Full-text search over message content and conversation name.
Example:refund policy
channelsstring
Comma-separated channels to filter by. Valid values: LIVE_CHAT, SHARED, OVERVIEW, API, WHATSAPP, INSTAGRAM, MESSENGER, SLACK, MAX_EXTENSION, MAX_WEB, MAX_API.
Example:WHATSAPP,API
feedback'POSITIVE' | 'NEGATIVE'
Only conversations containing a message with this feedback rating. Valid values: POSITIVE, NEGATIVE.
Example:POSITIVE
Response
A list of conversations
Example response
{
"results": [
{
"id": 42,
"name": "Anonymous Visitor",
"channel": "API",
"contact_id": "example",
"summary": "example",
"created_at": "example",
"updated_at": "example"
}
]
}