Skip to main content
GET
List WhatsApp messages

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.

Available options:
outbound,
inbound
Example:

"outbound"

status
enum<string>

Filters messages by delivery status.

Available options:
failed,
sent,
delivered,
undelivered,
expired,
rejected,
unknown
Example:

"delivered"

from_date
string<date>

Filters to messages created on or after this date, in YYYY-MM-DD format.

Example:

"2026-01-01"

to_date
string<date>

Filters to messages created on or before this date, in YYYY-MM-DD format.

Example:

"2026-01-31"

page
integer<int32>

Page number to retrieve. Default 1.

Example:

1

per_page
integer<int32>

Number of records to return per page. Default 25.

Example:

25

Response

A paginated list of WhatsApp messages.

messages
WhatsAppMessageListItem · object[]
required

Messages that match the request.

pagination
Pagination · object
required