Search Messages
Supported & TestedSearch stored messages by keyword.
POSThttps://api.waplix.io/api/v1/messages/search
Authentication
Authorization: Bearer YOUR_API_KEY Parameters Specification
| Parameter | Type | Required | Description |
|---|---|---|---|
| instance_id | string | Required | Required Waplix instance id |
| query | string | Required | Required search text query |
| limit | number | Optional | Optional number, 1 to 100 |
instance_id
stringReq Required Waplix instance id
query
stringReq Required search text query
limit
numberOpt Optional number, 1 to 100
Usage Notes
Verified on production. Public documentation uses sanitized example data only.
Request Payload Example
Request
curl -X POST "https://api.waplix.io/api/v1/api/v1/messages/search" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"instance_id": "demo_instance",
"query": "docs",
"limit": 5
}'Success Response
Response · 200 OK
{
"success": true,
"data": {
"instance_id": "demo_instance",
"query": "docs",
"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": "Docs test edited",
"media_url": null,
"message_id": "MSG_DEMO_001",
"status": "READ",
"created_at": "2026-06-27T17:46:02.000Z"
}
]
}
} Was this page helpful?