---
title: "List WhatsApp Business Accounts"
method: GET
path: "/api/messaging/whatsapp/businesses"
tags: ["WhatsApp Businesses"]
---

# List WhatsApp Business Accounts

`GET /api/messaging/whatsapp/businesses`

## Request

- Base URL: `https://{Your_Space_Name}.signalwire.com`
- URL: `https://{Your_Space_Name}.signalwire.com/api/messaging/whatsapp/businesses`
- Auth: HTTP basic

Returns the WhatsApp Business Accounts connected to the project. Each account owns WhatsApp numbers and message templates. Use a `whatsapp_business_id` from this list when creating or filtering [message templates](/docs/platform/messaging/whatsapp/message-templates); use [List WhatsApp numbers](/docs/apis/rest/whatsapp/list-whatsapp-numbers) when you need a `whatsapp:`-prefixed sender address instead.

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Numbers_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Response `200`

The request has succeeded.

- WhatsAppBusinessListResponse: Response containing a list of WhatsApp Business Accounts.
  - `data` WhatsAppBusiness[], required: List of WhatsApp Business Accounts connected to the Space.
    - `whatsapp_business_id` string, uuid, required: Universal Unique Identifier.
    - `business_name` string, nullable, required: The business name as registered with Meta.
    - `business_portfolio_id` string, nullable, required: The Meta business portfolio ID associated with the account.
    - `waba_id` string, required: The WhatsApp Business Account ID (WABA ID) assigned by Meta.
    - `created_at` string, required: The date and time when the record was created.
    - `updated_at` string, required: The date and time when the record was last updated.

## Other responses

- `401`: Access is unauthorized.
- `500`: An internal server error occurred.

## Changes

> 173 revisions in range; 3 could not be searched.

- **2026-07-20** `14b262a4830d`: 1 info
  - endpoint added
- **2026-07-20** `6e5c9df70369`: 1 breaking
  - api path removed without deprecation
- **2026-07-16** `13da5e8c3990`: 1 info
  - endpoint added
- **2026-07-10** `0f65a5bc6e5c`: 1 breaking
  - api path removed without deprecation
- **2026-07-08** `a888562fa415`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/signalwire/apis/signalwire-rest-api/changes/api/messaging/whatsapp/businesses/get.md)

---

[API](https://skmtc.dev/signalwire/apis/signalwire-rest-api.md) - [All operations](https://skmtc.dev/signalwire/apis/signalwire-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signalwire/apis/signalwire-rest-api/revisions/7307749294e0?raw)