Skip to main content
GET
/
v1
/
messaging
/
conversations
Conversations API
curl --request GET \
  --url https://api.example.com/v1/messaging/conversations

Documentation Index

Fetch the complete documentation index at: https://docs.vobiz.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authentication: X-Auth-ID, X-Auth-Token, Accept: application/json
A conversation is a thread between your WhatsApp number and one customer, sorted by most recent activity. Messages are cursor-paginated - pass the cursor from the previous response to fetch older messages.

​
List conversations

GET https://api.vobiz.ai/v1/messaging/conversations
Returns all WhatsApp conversations for your account across all channels, ordered by most recent message.
cURL
curl -X GET \
  "https://api.vobiz.ai/v1/messaging/conversations" \
  -H "X-Auth-ID: {auth_id}" \
  -H "X-Auth-Token: {auth_token}"
200 OK
{
  "data": [{
    "id": "conv_abc123",
    "channel_id": "2f8892e1-59b7-40a2-b518-e7a7c31a754d",
    "contact": { "id": "cnt_xyz789", "name": "Rahul Sharma", "phone": "+919876543210" },
    "last_message": { "body": "Yes, I'd like to proceed.", "direction": "inbound", "timestamp": "2026-03-17T14:22:00Z" },
    "unread_count": 2,
    "status": "open"
  }],
  "meta": { "total": 48, "page": 1 }
}

​
List messages in a conversation

GET https://api.vobiz.ai/v1/messaging/conversations/{conversation_id}/messages
Returns paginated messages for a specific conversation, newest first.
ParamDefaultDescription
limit50Max messages per page
cursor-Message ID to paginate from (returns older messages)
curl -X GET \
  "https://api.vobiz.ai/v1/messaging/conversations/{conversation_id}/messages?limit=50" \
  -H "X-Auth-ID: {auth_id}" \
  -H "X-Auth-Token: {auth_token}"
200 OK
{
  "data": [
    { "id": "msg_002", "type": "text", "direction": "outbound", "body": "How can I help?", "status": "read", "timestamp": "2026-03-17T14:20:00Z" },
    { "id": "msg_001", "type": "text", "direction": "inbound", "body": "Yes, I'd like to proceed.", "timestamp": "2026-03-17T14:22:00Z" }
  ],
  "cursor": "msg_001"
}