Get All Chats

Supported & Tested

Return the chat list for a connected Waplix instance.

GEThttps://api.waplix.io/api/v1/chats/index?instance_id=39058&limit=50
Authentication
Authorization: Bearer YOUR_API_KEY
Parameters Specification
instance_id
stringReq

Required Waplix instance id

Usage Notes
Verified on production. Public documentation uses sanitized example data only.
Request Payload Example
Request
curl -X GET "https://api.waplix.io/api/v1/api/v1/chats/index?instance_id=39058&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"
Success Response
Response · 200 OK
{
  "success": true,
  "data": {
    "items": [
      {
        "chat_id": "15551234567@s.whatsapp.net",
        "phone_chat_id": "15551234567@s.whatsapp.net",
        "lid_chat_id": null,
        "display_id": "15551234567@s.whatsapp.net",
        "resolution_source": "stored_chat_id",
        "name": "John Doe",
        "is_group": false,
        "unread_count": 0,
        "timestamp": "2026-06-27T17:46:24.000Z",
        "archived": false,
        "pinned": false,
        "last_message": {
          "message_id": "MSG_DEMO_001",
          "direction": "outgoing",
          "message_type": "text",
          "message": "Hello from Waplix API docs.",
          "status": "READ",
          "created_at": "2026-06-27T17:46:24.000Z"
        }
      },
      {
        "chat_id": "120363000000000000@g.us",
        "phone_chat_id": "120363000000000000@g.us",
        "lid_chat_id": null,
        "display_id": "120363000000000000@g.us",
        "resolution_source": "stored_chat_id",
        "name": "Demo User",
        "is_group": true,
        "unread_count": 0,
        "timestamp": "2026-06-27T17:46:24.000Z",
        "archived": false,
        "pinned": false,
        "last_message": {
          "message_id": "MSG_DEMO_001",
          "direction": "outgoing",
          "message_type": "text",
          "message": "Hello from Waplix API docs.",
          "status": "READ",
          "created_at": "2026-06-27T17:46:24.000Z"
        }
      }
    ]
  }
}
Was this page helpful?