---
title: "List WhatsApp messages"
method: GET
path: "/v1/whatsapp/messages"
tags: ["WhatsApp"]
---

# List WhatsApp messages

`GET /v1/whatsapp/messages`

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

## Query parameters

- `direction` 'outbound' | 'inbound'
- `status` 'failed' | 'sent' | 'delivered' | 'undelivered' | 'expired' | 'rejected' | 'unknown'
- `from_date` string, date
- `to_date` string, date
- `page` integer
- `per_page` integer

## Response `200`

A paginated list of WhatsApp messages.

- WhatsAppMessageListResponse
  - `messages` WhatsAppMessageListItem[], required — Messages that match the request.
    - `uuid` string, uuid, required — Message ID.
    - `direction` 'outbound' | 'inbound', required — Message direction.
    - `status` 'failed' | 'sent' | 'delivered' | 'undelivered' | 'expired' | 'rejected' | 'unknown', required — Message delivery status.
    - `from` string, required — For `outbound` messages, the sender's phone number. For `inbound`, the originating phone number.
    - `to` string, required — For `outbound` messages, the recipient's phone number. For `inbound`, the sender's phone number.
    - `country` string, nullable — Recipient's country, derived from the phone number.
    - `created_at` string, required — Date and time the message was created, in ISO 8601 format.
  - `pagination` Pagination, required
    - `current_page` integer, required — Current page number.
    - `per_page` integer, required — Number of records per page.
    - `total` integer, required — Total number of records.
    - `total_pages` integer, required — Total number of pages.

## Other responses

- `400` — Returns when the request body or parameters are invalid.
- `401` — Returns when the request is not authenticated.
- `402` — Returns when the account balance is insufficient.
- `403` — Returns when the account is suspended.
- `404` — Returns when WhatsApp is not available or not enabled for the account.
- `429` — Returns when the account has exceeded its request rate limit.

## Changes

- **2026-09-23** `8bde78f383c6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/wavix/apis/wavix-apis/changes/v1/whatsapp/messages/get.md)

---

[API](https://skmtc.dev/wavix/apis/wavix-apis.md) · [All operations](https://skmtc.dev/wavix/apis/wavix-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/wavix/apis/wavix-apis/revisions/43ad912a102a?raw)