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

# List WhatsApp senders

`GET /v1/whatsapp/senders`

## Request

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

Returns a paginated list of the WhatsApp senders in your account's WhatsApp Business Accounts, each with the WhatsApp Business Account it belongs to.

Every send needs a registered sender's number in `from`, and this is where that number comes from.

**Behavior:** Senders are ordered from newest to oldest. When both `status` and `waba_id` are specified, a sender must match both filters.

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

## Query parameters

- `status` 'banned' | 'connected' | 'deleted' | 'disconnected' | 'flagged' | 'migrated' | 'pending' | 'rate_limited' | 'restricted' | 'unknown' | 'unverified'
- `waba_id` string
- `page` integer
- `per_page` integer

## Response `200`

A paginated list of WhatsApp senders.

- WhatsAppSenderListResponse: Returned by `whatsapp_senders_list`.
  - `senders` WhatsAppSender[], required: Senders that match the request.
    - `phone_number` string, required: Sender's phone number in E.164 format.
    - `display_name` string, nullable, required: Sender's WhatsApp display name.
    - `status` 'banned' | 'connected' | 'deleted' | 'disconnected' | 'flagged' | 'migrated' | 'pending' | 'rate_limited' | 'restricted' | 'unknown' | 'unverified', required: Sender registration status with the provider. Possible values: - `banned` — The provider banned the sender. - `connected` — The sender can send messages within its messaging limit. - `deleted` — The sender was deleted. - `disconnected` — The sender is disconnected from the provider. - `flagged` — The sender's quality rating dropped to low. The status returns to `connected` if the rating returns to medium or high within seven days. - `migrated` — The sender was migrated. - `pending` — Registration with the provider is in progress. - `rate_limited` — The provider is rate limiting the sender. - `restricted` — The sender reached its messaging limit. It can't start new conversations until the 24-hour window resets, but it can still reply to customers who messaged it. - `unknown` — The provider hasn't reported a status. - `unverified` — The sender isn't verified.
    - `quality_rating` 'high' | 'medium' | 'low' | 'unknown' | 'null', nullable, required: Sender's messaging quality rating. Meta rates quality from customer feedback over the past seven days, such as blocks and reports. Possible values: - `high` — High quality. - `medium` — Medium quality. - `low` — Low quality. - `unknown` — Not rated yet.
    - `waba` WhatsAppWaba, required: A WhatsApp Business Account linked to your account, embedded in senders and templates.
      - `id` string, required: ID of the WhatsApp Business Account. Pass it to `whatsapp_wabas_get` to retrieve the account.
      - `name` string, nullable, required: Name of 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 breaking
  - removed the required property `senders/items/message_tier` from the response with the `200` status
- **2026-10-07** `ea33150ace54`: 1 info
  - endpoint added

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