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.

GET/v2.0/chats/conversations

Query Parameters

Query

ParameterTypeDescription
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...",
      "phone": "919876543210",
      "contactName": "Surya Prakash",
      "brandNumber": "917012345678",
      "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
  }
}