Message History

Supported & Tested

Query and fetch paginated messages logs from Waplix internal SQLite databases.

POSThttps://api.waplix.io/api/v1/messages/fetch
Authentication
Authorization: Bearer YOUR_API_KEY
Parameters Specification
instance_id
stringReq

Waplix instance id slot

chat_id
stringReq

Recipient JID or phone number target

limit
numberOpt

Limit details logs count (1 to 100)

Request Payload Example
Request
curl -X POST "https://api.waplix.io/api/v1/api/v1/messages/fetch" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "instance_id": "demo_instance",
  "chat_id": "15551234567@s.whatsapp.net",
  "limit": 5
}'
Success Response
Response · 200 OK
{
  "success": true,
  "data": {
    "instance_id": "demo_instance",
    "chat_id": "15551234567@s.whatsapp.net",
    "source": "message_logs",
    "items": [
      {
        "instance_id": "demo_instance",
        "direction": "outgoing",
        "from": null,
        "to": "15551234567@s.whatsapp.net",
        "chat_id": "15551234567@s.whatsapp.net",
        "message_type": "text",
        "message": "Hello from Waplix API docs.",
        "media_url": null,
        "message_id": "MSG_DEMO_001",
        "status": "READ",
        "created_at": "2026-06-27T17:46:02.000Z"
      }
    ]
  }
}
Was this page helpful?