Sign in
WhatsApp

List WhatsApp messages

Returns a paginated list of WhatsApp messages for the authenticated account.

get/v1/whatsapp/messages

Query parameters

direction'outbound' | 'inbound'
Example:outbound

Filters messages by direction.

status'failed' | 'sent' | 'delivered' | 'undelivered' | 'expired' | 'rejected' | 'unknown'
Example:delivered

Filters messages by delivery status.

from_datestring date
Example:2026-01-01

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

to_datestring date
Example:2026-01-31

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

pageinteger
Example:1

Page number to retrieve. Default 1.

per_pageinteger
Example:25

Number of records to return per page. Default 25.

Response

A paginated list of WhatsApp messages.

Example response

{
  "messages": [
    {
      "uuid": "3a525ca2-6909-4c72-9399-905adf7f3a74",
      "direction": "outbound",
      "status": "delivered",
      "from": "14155550100",
      "to": "447537151866",
      "country": "GB",
      "created_at": "2026-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "current_page": 2,
    "per_page": 25,
    "total": 101,
    "total_pages": 5
  }
}

Changes

Changed in 1 of the 55 revisions of this API.1