---
title: "List WhatsApp numbers"
method: GET
path: "/api/messaging/whatsapp/numbers"
tags: ["WhatsApp Numbers"]
---

# List WhatsApp numbers

`GET /api/messaging/whatsapp/numbers`

Returns the WhatsApp numbers connected to your Space. Each record includes its association with a WhatsApp Business Account, voice-capability flags, and the resource IDs used for routing calls or messages. Use `phone_number` (prefixed with `whatsapp:`) as the `from` address when [sending messages](/docs/platform/messaging/whatsapp/send-messages).

#### 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.

- WhatsAppNumberListResponse — Response containing a list of WhatsApp numbers.
  - `data` WhatsAppNumber[], required — List of WhatsApp numbers available to the Space.
    - `id` string, uuid, required — Universal Unique Identifier.
    - `business_phone_number_id` string, required — The Meta phone number ID for this WhatsApp number.
    - `phone_number` string, required — The WhatsApp number, prefixed with `whatsapp:`. Use this value as the `from` address when sending messages.
    - `calling_handler_resource_id` string, uuid, required — Universal Unique Identifier.
    - `messaging_handler_resource_id` string, uuid, required — Universal Unique Identifier.
    - `business_name` string, nullable, required — The business name as registered with Meta.
    - `waba_id` string, required — The WhatsApp Business Account ID (WABA ID) assigned by Meta.
    - `whatsapp_business_id` string, uuid, required — Universal Unique Identifier.
    - `voice_enabled` boolean, required — Whether SIP calling is enabled for this number.
    - `voice_capable` boolean, required — Whether this number can place and receive calls — true when a calling handler is configured and voice is enabled.
    - `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.

---

[API](https://skmtc.net/signalwire/apis/signalwire-rest-api.md) · [All operations](https://skmtc.net/signalwire/apis/signalwire-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signalwire/signalwire-rest-api/versions/05c5164b85c7/schema)