v77

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-08-012528701.8 MB
WhatsApp Numbers

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

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.

get/api/messaging/whatsapp/numbers

Response

The request has succeeded.

Example response

{
  "data": [
    {
      "business_phone_number_id": "102290129340398",
      "phone_number": "whatsapp:+15557654321",
      "business_name": "Acme, Inc.",
      "waba_id": "109876543210987",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    }
  ]
}