Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Conversation identifier from sms_thread_list / MessageOutput.threadId

Query Parameters

limit
integer
default:50

Maximum messages to return (1–100, default 50). When the conversation is longer, the MOST RECENT limit messages are returned (still ordered oldest-first among themselves) — reach deeper history via GET /messages?threadId=.

Required range: 1 <= x <= 100

Response

200 - application/json

OK

One SMS conversation with its message history

threadId
string
required

Conversation identifier

agentId
string
required

Agent that owns this conversation

participantAddress
string
required

The counterparty's phone number (E.164)

agentAddress
string
required

The agent's own phone number used in this conversation

messages
object[]
required

Messages in chronological (oldest-first) reading order. When the conversation is longer than limit, this is its most recent window.

messageCount
integer
required

Total messages in the conversation

hasMore
boolean
required

True when the conversation holds more messages than this response returned (older ones precede messages)