Conversations
List conversations
GET
List conversations across chat widget, WhatsApp, Instagram and email (unified inbox).
bearer conversations:readheader
AuthorizationBearer <token>API key (rsl_live_…) from Settings → Developers.
Scope: conversations:read
view?stringescalated = needs a person, in_progress = AI or waiting for customer, resolved, all, snoozed, starred, trash, spam (email only).
Default
"all"Value in
"all""escalated""in_progress""resolved""snoozed""starred""trash""spam"channel?stringDefault
"all"Value in
"all""chat""email""whatsapp""instagram"agentId?stringOnly conversations handled by this AI agent.
Length
1 <= length <= 64starred?booleanOnly starred conversations; combine with view, e.g. view=escalated&starred=true.
order?stringBy last activity (resolved view: by resolution time).
Default
"desc"Value in
"desc""asc"limit?integerPage size, 1–100 (default 25).
Range
1 <= value <= 100Default
25cursor?stringCursor from the previous page's nextCursor. Omit for the first page.
Length
length <= 4000Success
application/json- response
data*array<>nextCursor*stringhasMore*booleancurl -X GET "https://example.com/conversations"{ "data": [ { "id": "string", "channel": "chat", "status": "open", "state": "waiting_human", "view": "escalated", "subject": "string", "preview": "string", "contact": { "id": "string", "name": "string", "email": "string" }, "agentId": "string", "assignee": { "memberId": "string", "name": "string" }, "inbox": { "id": "string", "name": "string" }, "tags": [ "string" ], "isStarred": true, "snoozedUntil": 0, "topic": "string", "language": "string", "lastActor": "customer", "isArchived": true, "createdAt": 0, "lastActivityAt": 0, "resolvedAt": 0, "dashboardUrl": "string" } ], "nextCursor": "string", "hasMore": true}