Retrieve a conversation
Returns one conversation with its participants, channel and counters. Use it to refresh a thread’s unreadCount or lastMessageAt after a new message arrives. To read the messages themselves, call GET /conversations/{id}/messages.
curl --request GET \
--url https://api.vobiz.ai/api/v1/sms/conversations/{id} \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>'from vobiz import Vobiz
client = Vobiz(api_key="MA_XXXXXXXX", auth_token="YOUR_AUTH_TOKEN")
client.sms.conversations.get_conversation(
id="c7d1e9a3-2b4f-4a6c-8d5e-1f3a9b7c2e04",
)
const options = {
method: 'GET',
headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};
fetch('https://api.vobiz.ai/api/v1/sms/conversations/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "c7d1e9a3-2b4f-4a6c-8d5e-1f3a9b7c2e04",
"accountId": "MA_XXXXXXXX",
"participantA": "+14155550100",
"participantB": "+14155550123",
"channel": "sms",
"lastMessageAt": "2026-10-16T21:23:51Z",
"messageCount": 3,
"unreadCount": 1,
"createdAt": "2026-10-16T21:23:02Z"
}{
"error": "missing or invalid credentials"
}{
"error": "conversation not found"
}{
"error": "internal error"
}Authorizations
Your Vobiz account Auth ID (MA_XXXXXXXX).
Your Vobiz account Auth Token.
Path Parameters
The conversation id (UUID), from GET /conversations or the conversationId on any message.
Response
The conversation.
A two-way thread between one of your numbers (or RCS senders) and one contact on one channel. Vobiz creates it with the first message in either direction and adds every later message between the same pair on that channel.
Unique identifier of the conversation (UUID). Pass it to the conversation endpoints; messages carry it as conversationId.
"c7d1e9a3-2b4f-4a6c-8d5e-1f3a9b7c2e04"
Your Vobiz account ID (Auth ID), for example MA_XXXXXXXX.
"MA_XXXXXXXX"
Your side of the thread: your number in E.164 format, or the senderName of your RCS sender.
"+14155550100"
The contact's phone number in E.164 format.
"+14155550123"
Channel the thread runs on: sms, mms or rcs. The same two parties have a separate conversation on each channel.
sms, mms, rcs Time of the latest message in the thread, sent or received (ISO 8601, UTC). Conversation lists are ordered by it, newest first.
"2026-10-16T21:23:51Z"
Total number of messages in the thread, in both directions.
3
Number of messages added to the thread since it was last marked read. POST /conversations/{id}/read resets it to 0.
1
When the thread was last marked read (ISO 8601, UTC). Omitted until you first call POST /conversations/{id}/read.
"2026-10-17T08:46:55Z"
When the conversation was created, as an RFC 3339 / ISO 8601 timestamp in UTC.
"2026-10-16T21:23:02Z"
Was this page helpful?
curl --request GET \
--url https://api.vobiz.ai/api/v1/sms/conversations/{id} \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>'from vobiz import Vobiz
client = Vobiz(api_key="MA_XXXXXXXX", auth_token="YOUR_AUTH_TOKEN")
client.sms.conversations.get_conversation(
id="c7d1e9a3-2b4f-4a6c-8d5e-1f3a9b7c2e04",
)
const options = {
method: 'GET',
headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};
fetch('https://api.vobiz.ai/api/v1/sms/conversations/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "c7d1e9a3-2b4f-4a6c-8d5e-1f3a9b7c2e04",
"accountId": "MA_XXXXXXXX",
"participantA": "+14155550100",
"participantB": "+14155550123",
"channel": "sms",
"lastMessageAt": "2026-10-16T21:23:51Z",
"messageCount": 3,
"unreadCount": 1,
"createdAt": "2026-10-16T21:23:02Z"
}{
"error": "missing or invalid credentials"
}{
"error": "conversation not found"
}{
"error": "internal error"
}