List conversations
Returns your conversations, most recently active first (ordered by lastMessageAt). A conversation is the thread between one of your numbers and one contact on one channel, and Vobiz creates it with the first message in either direction.
curl --request GET \
--url https://api.vobiz.ai/api/v1/sms/conversations \
--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.list_conversations()
const options = {
method: 'GET',
headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};
fetch('https://api.vobiz.ai/api/v1/sms/conversations', 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"
},
{
"id": "1a9c3e5b-7d2f-4b8a-9c6e-0f4d2b8a6c13",
"accountId": "MA_XXXXXXXX",
"participantA": "+14155550100",
"participantB": "+14155550124",
"channel": "sms",
"lastMessageAt": "2026-10-16T13:25:41Z",
"messageCount": 2,
"unreadCount": 0,
"lastReadAt": "2026-10-16T21:24:15Z",
"createdAt": "2026-10-16T13:25:41Z"
}
]{
"error": "missing or invalid credentials"
}{
"error": "internal error"
}Authorizations
Your Vobiz account Auth ID (MA_XXXXXXXX).
Your Vobiz account Auth Token.
Query Parameters
Maximum number of conversations to return, from 1 to 100. Defaults to 20; a value outside that range also returns 20.
1 <= x <= 100Number of conversations to skip before the page starts, 0 or greater. Defaults to 0. Add the page size to it to fetch the next page.
x >= 0Response
A page of conversations. Empty array when none.
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 \
--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.list_conversations()
const options = {
method: 'GET',
headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};
fetch('https://api.vobiz.ai/api/v1/sms/conversations', 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"
},
{
"id": "1a9c3e5b-7d2f-4b8a-9c6e-0f4d2b8a6c13",
"accountId": "MA_XXXXXXXX",
"participantA": "+14155550100",
"participantB": "+14155550124",
"channel": "sms",
"lastMessageAt": "2026-10-16T13:25:41Z",
"messageCount": 2,
"unreadCount": 0,
"lastReadAt": "2026-10-16T21:24:15Z",
"createdAt": "2026-10-16T13:25:41Z"
}
]{
"error": "missing or invalid credentials"
}{
"error": "internal error"
}