Message History
Supported & TestedQuery 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
| Parameter | Type | Required | Description |
|---|---|---|---|
| instance_id | string | Required | Waplix instance id slot |
| chat_id | string | Required | Recipient JID or phone number target |
| limit | number | Optional | Limit details logs count (1 to 100) |
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?