Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

JWT Bearer token obtained from authentication. Pass as: Authorization: Bearer

Query Parameters

agentId
string

Filter conversations to one agent. Optional for master keys (omit for every agent in the org); ignored for agent keys, which always see only their own.

limit
integer
default:20

Maximum conversations to return per page (1–100, default 20)

Required range: 1 <= x <= 100
offset
integer
default:0

Conversations to skip, for paging through the list

Required range: x >= 0
unread
boolean

When true, return only conversations with at least one unread message

Response

200 - application/json

OK

Paginated list of SMS conversations

items
object[]
required

Conversation summaries, newest activity first

total
integer
required

Total conversations matching the query

hasMore
boolean
required

Whether more conversations exist past this page