Skip to main content
GET
List conversations

Authorizations

X-API-Key
string
header
required

API key with format cs_live_xxx

Query Parameters

campaign_id
string<uuid> | null

Filter by campaign ID

status
string | null

Filter by status: unread, read, starred

search
string | null

Search by lead name, email, or subject

page
integer
default:1

Page number

Required range: x >= 1
limit
integer
default:50

Items per page

Required range: 1 <= x <= 200

Response

Conversations retrieved

Paginated list of conversation threads.

success
boolean
required
message
string
required
threads
PublicThreadItem · object[]
required

List of conversation threads

total_count
integer
required

Total matching threads

page
integer
required

Current page

limit
integer
required

Items per page

total_pages
integer
required

Total pages

has_next
boolean
required

Whether more pages exist

has_prev
boolean
required

Whether a previous page exists

unread_count
integer
required

Number of unread threads in the current result set

starred_count
integer
required

Number of starred threads in the current result set