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

ParameterTypeDescription
platformstringOnly this channel: whatsapp | instagram | messenger | line, plus web when web chat is on for your account. Anything else is 400 INVALID_PLATFORM
channelIdstringOnly conversations on this Instagram / Messenger / LINE account or web chat channel id
brandNumberstringFilter to conversations on this brand number
archivedbooleantrue → only archived; false → only non-archived
searchstringCase-insensitive match on phone, contactName, or last message
pagenumber1-based page indexDefault: 1
limitnumberPage 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

ParameterTypeDescription
platformstringwhatsapp, instagram, messenger, line or web. Older WhatsApp rows with no stored channel read as whatsapp
phonestring | nullThe customer's WhatsApp number. null on other channels
brandNumberstring | nullYour WhatsApp number. null on other channels
channelIdstring | nullInstagram / Messenger / LINE account id, or the web chat channel id. null on WhatsApp
customerIdstring | nullThe 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.