List Conversations
Returns conversations for the calling org, sorted by lastMessageAt descending. Each row carries the last-message preview, unread count, and pin/star/archive flags — ideal for building an inbox view. Every row says which channel it is on in platform.
GET/v2.0/chats/conversations
Query Parameters
Query
| Parameter | Type | Description |
|---|---|---|
| platform | string | Only this channel: whatsapp | instagram | messenger | line, plus web when web chat is on for your account. Anything else is 400 INVALID_PLATFORM |
| channelId | string | Only conversations on this Instagram / Messenger / LINE account or web chat channel id |
| brandNumber | string | Filter to conversations on this brand number |
| archived | boolean | true → only archived; false → only non-archived |
| search | string | Case-insensitive match on phone, contactName, or last message |
| page | number | 1-based page indexDefault: 1 |
| limit | number | Page size (1–100)Default: 20 |
Example
cURL
curl -X GET "https://api.sendiee.com/v2.0/chats/conversations?archived=false&limit=20" \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"success": true,
"data": [
{
"conversationId": "664a...",
"platform": "whatsapp",
"phone": "919876543210",
"contactName": "Surya Prakash",
"brandNumber": "917012345678",
"channelId": null,
"customerId": null,
"lastMessage": "Thanks!",
"lastMessageAt": "2026-04-29T05:18:00.000Z",
"unreadCount": 1,
"isArchived": false,
"isMuted": false,
"isPinned": false,
"isStarred": true,
"summary": "Customer asked about order #1234 and confirmed delivery",
"createdAt": "2026-04-15T10:00:00.000Z"
}
],
"pagination": {
"total": 142,
"page": 1,
"limit": 20,
"totalPages": 8,
"hasMore": true
}
}Channel fields
Per row
| Parameter | Type | Description |
|---|---|---|
| platform | string | whatsapp, instagram, messenger, line or web. Older WhatsApp rows with no stored channel read as whatsapp |
| phone | string | null | The customer's WhatsApp number. null on other channels |
| brandNumber | string | null | Your WhatsApp number. null on other channels |
| channelId | string | null | Instagram / Messenger / LINE account id, or the web chat channel id. null on WhatsApp |
| customerId | string | null | The customer's id on that channel. For web chat, the visitor id (wv_…). null on WhatsApp |
Web chat conversations
cURL
curl -X GET "https://api.sendiee.com/v2.0/chats/conversations?platform=web&limit=20" \
-H "Authorization: Bearer YOUR_API_KEY"Reply with Send a Web Chat Message and read the thread with Chat History using conversationId.