GET
/
v1
/
whatsapp
/
messages
List WhatsApp messages
curl --request GET \
  --url https://api.wavix.com/v1/whatsapp/messages \
  --header 'Authorization: Bearer <token>'
{
  "messages": [
    {
      "uuid": "9d4e1c7a-2b86-4f3d-b5a0-71e8c3f6a924",
      "direction": "inbound",
      "status": "delivered",
      "from": "+447537151866",
      "to": "+14155550100",
      "country": "GB",
      "created_at": "2026-01-15T10:45:00.456Z"
    },
    {
      "uuid": "3a525ca2-6909-4c72-9399-905adf7f3a74",
      "direction": "outbound",
      "status": "delivered",
      "from": "+14155550100",
      "to": "+447537151866",
      "country": "GB",
      "created_at": "2026-01-15T10:30:00.123Z"
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 25,
    "total": 2,
    "total_pages": 1
  }
}

Authorizations

​
Authorization
string
header
required

Wavix API key. Pass as Authorization: Bearer <api_key>. Keys support per-resource scopes (none / read / write). See Restricted keys and scopes.

Query Parameters

​
direction
enum<string>

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.
Available options:
outbound,
inbound
​
status
enum<string>

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.
Available options:
sent,
delivered,
undelivered,
expired,
rejected,
unknown
​
from
string

Filters messages by the from phone number, in E.164 format. The leading + is optional.

Pattern: ^\+?\d{6,20}$
​
to
string

Filters messages by the to phone number, in E.164 format. The leading + is optional.

Pattern: ^\+?\d{6,20}$
​
from_date
string<date>

Filters messages to those created on or after the start of this date in your account's time zone, in YYYY-MM-DD format.

​
to_date
string<date>

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
integer<int32>
default:1

Page number to retrieve. Page numbering starts at 1. Defaults to 1.

​
per_page
integer<int32>
default:25

Number of records to return per page. Defaults to 25. Values above 100 are treated as 100.

Response

A paginated list of WhatsApp messages.

Returned by whatsapp_messages_list.

​
messages
WhatsAppMessageListItem · object[]
required

Messages that match the request.

​
pagination
Pagination · object
required