Message Logs Guide

Use this endpoint to monitor the message delivery history on your device. This endpoint supports powerful filters and pagination to facilitate auditing large datasets.

Key Filter Parameters

Parameter	Explanation	Example
status	Message delivery status	SENT, DELIVERED, READ, FAILED, PENDING
recipient	Recipient number	628123...
start_date	Start of the date range	2024-01-01
end_date	End of the date range	2024-01-07

Understanding Message Statuses

1. PENDING: The message is in the queue and will be processed by the worker shortly.
2. SENT: The message has been successfully sent to the WhatsApp server.
3. DELIVERED: The message has been received by the target phone (gray double checkmarks).
4. READ: The message has been read by the recipient (blue double checkmarks).
5. FAILED: Delivery failed (usually because the number is not registered or the connection was lost).
6. EXPIRED: The message could not be sent before the specified expiration timeout.
7. CANCELLED: The message was canceled by the user while the status was still PENDING.

info

Message data in Wagy is archived periodically. Ensure you perform regular synchronizations if you require long-term log storage on your side.

---

List messages

GET 
/:device_id/messages

Fetch message history with filtering and pagination.

Request

Responses

200

OK

401

Unauthorized