List WhatsApp messages
Returns a paginated list of the WhatsApp messages your account sent and received, each with its direction, delivery status, and phone numbers.
Messages that customers send to your senders appear here alongside the messages you sent.
Behavior: Messages are ordered from newest to oldest. If direction isn’t specified, the response includes both directions, and when several filters are specified, a message must match all of them. Returns 400 when direction, from, or to isn’t valid.
Requires: Your account must have WhatsApp enabled, must have a subscription plan, and must not be blocked or suspended.
Authorizations
Wavix API key. Pass as Authorization: Bearer <api_key>. Keys support per-resource scopes (none / read / write). See Restricted keys and scopes.
Query Parameters
Filters messages by direction. Possible values:
outbound— The message was sent from your account to a recipient.inbound— A customer sent the message to one of your senders.
outbound, inbound Filters messages by delivery status. Inbound messages always have delivered status. Possible values:
sent— The message isn't delivered yet.delivered— The message was delivered to the recipient.undelivered— The message was sent but not delivered.expired— The message expired before it was delivered.rejected— The message was permanently rejected before or by the provider.unknown— The provider hasn't reported a status.
sent, delivered, undelivered, expired, rejected, unknown Filters messages by the from phone number, in E.164 format. The leading + is optional.
^\+?\d{6,20}$Filters messages by the to phone number, in E.164 format. The leading + is optional.
^\+?\d{6,20}$Filters messages to those created on or after the start of this date in your account's time zone, in YYYY-MM-DD format.
Filters messages to those created on or before the end of this date in your account's time zone, in YYYY-MM-DD format.
Page number to retrieve. Page numbering starts at 1. Defaults to 1.
Number of records to return per page. Defaults to 25. Values above 100 are treated as 100.