---
title: "List WhatsApp Business Accounts"
method: GET
path: "/v1/whatsapp/wabas"
tags: ["WhatsApp"]
---

# List WhatsApp Business Accounts

`GET /v1/whatsapp/wabas`

## Request

- Base URL: `https://api.wavix.com`
- URL: `https://api.wavix.com/v1/whatsapp/wabas`
- Auth: HTTP bearer

Returns a paginated list of the WhatsApp Business Accounts linked to your account, each with its messaging limit and number of senders.

**Behavior:** WhatsApp Business Accounts are ordered from newest to oldest.

**Requires:** Your account must have WhatsApp enabled, must have a subscription plan, and must not be blocked or suspended.

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

A paginated list of WhatsApp Business Accounts.

- WhatsAppWabaListResponse: Returned by `whatsapp_wabas_list`.
  - `wabas` WhatsAppBusinessAccount[], required: WhatsApp Business Accounts linked to your account.
    - `id` string, required: ID of the WhatsApp Business Account, as returned in `waba.id` on senders and templates.
    - `name` string, nullable, required: Name of the WhatsApp Business Account.
    - `messaging_limit` 'up_to_250' | 'up_to_2k' | 'up_to_10k' | 'up_to_100k' | 'unlimited': Maximum number of unique customers the WhatsApp Business Account can start conversations with in a rolling 24-hour period. Omitted when the limit isn't known yet. Possible values: - `up_to_250` — Up to 250 unique customers. - `up_to_2k` — Up to 2,000 unique customers. - `up_to_10k` — Up to 10,000 unique customers. - `up_to_100k` — Up to 100,000 unique customers. - `unlimited` — No limit on unique customers.
    - `sender_count` integer, required: Number of senders registered in the WhatsApp Business Account.
  - `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

- `401`: Authentication failed or wasn't provided.
- `403`: Returns when the account is suspended, blocked, or has no subscription plan, or the API key has no access to the endpoint.
- `404`: WhatsApp isn't available for your account, or the WhatsApp channel isn't enabled for it yet.
- `429`: Returns when the account has exceeded its request rate limit.
- `500`: Returns when an unexpected error occurs on the server; the request may be retried.
- `503`: Returns when the service is temporarily unavailable; the request may be retried.

## Changes

- **2026-10-14** `e8858666097f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wavix/apis/wavix-apis/changes/v1/whatsapp/wabas/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/f2dde79f05ab?raw)