---
title: "Get a WhatsApp number"
method: GET
path: "/api/messaging/whatsapp/numbers/{id}"
tags: ["WhatsApp Numbers"]
---

# Get a WhatsApp number

`GET /api/messaging/whatsapp/numbers/{id}`

Retrieves one connected WhatsApp number by SignalWire ID so you can inspect how it is used for outbound and inbound communication. Use [List WhatsApp numbers](/docs/apis/rest/whatsapp/list-whatsapp-numbers) to discover IDs. Standard SMS and MMS phone numbers use [Get phone number](/docs/apis/rest/phone-numbers/retrieve-phone-number).

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

## Path parameters

- `id` string, uuid, required — Universal Unique Identifier.

## Response `200`

The request has succeeded.

- WhatsAppNumberResponse — Response containing a single WhatsApp number.
  - `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.
- `404` — The server cannot find the requested resource.
- `500` — An internal server error occurred.

## Changes

> 137 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

[Change history](https://skmtc.dev/signalwire/apis/signalwire-rest-api/changes/api/messaging/whatsapp/numbers/:id/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-service-production.skmtc.workers.dev/v1/apis/signalwire/signalwire-rest-api/revisions/792d5b8e2970/schema)