Skip to main content
GET
List all conversations

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Query Parameters

cursor
string

Pagination cursor

limit
integer
default:25
Required range: 1 <= x <= 100
sort
string

Sort field (prefix with - for DESC)

channel
enum<string>
Available options:
sms,
whatsapp,
email,
rcs,
viber,
instagram,
messenger,
line,
telegram,
agent,
voice,
video,
apple_messages,
web_chat
status
enum<string>
Available options:
open,
closed,
pending,
snoozed,
active,
archived,
resolved
assigned_agent
string

Filter by assigned agent ID (legacy)

Search by contact name, phone, or email

tag
string

Filter by tag (legacy, single)

channels
string

Comma-separated list of channels

statuses
string

Comma-separated list of statuses (open,closed,pending,snoozed,...)

tags
string

Comma-separated tag list (ANY match)

assignee
string

"me", "unassigned", or a user id

date_from
string<date-time>
date_to
string<date-time>
segment_id
string
unread
enum<string>
Available options:
true,
false
has_agent
enum<string>
Available options:
true,
false
has_video_room
enum<string>
Available options:
true,
false
sentiment
enum<string>
Available options:
positive,
neutral,
negative
mentioned_internal
enum<string>
Available options:
true,
false
filters
string

JSON-encoded full filter AST (takes precedence)

Response

200 - application/json

Paginated list of conversations

Paginated list of conversations

data
object[]
meta
object