Phone Numbers

Returns all WhatsApp phone numbers (business profiles) connected to your organization. The id field returned here is the phone number ID used in all other endpoints. This id is different from the actual phone number itself.

Connect your phone number in the Bahasha Dashboard if you haven’t already.

List phone numbers


GET /v1/whatsapp/phone_numbers

cURL


curl https://api.bahasha.app/v1/whatsapp/phone_numbers \
  -H "Authorization: Bearer bh_live_xxxxxxxxxxxx"

JavaScript


const response = await fetch("https://api.bahasha.app/v1/whatsapp/phone_numbers", {
  headers: { "Authorization": "Bearer bh_live_xxxxxxxxxxxx" },
});
 
const phoneNumbers = await response.json();
console.log(phoneNumbers);

Python


import requests
 
response = requests.get(
    "https://api.bahasha.app/v1/whatsapp/phone_numbers",
    headers={"Authorization": "Bearer bh_live_xxxxxxxxxxxx"},
)
 
print(response.json())

Response


[
  {
    "id": "123456789",
    "display_name": "Acme Support",
    "phone_number": "+254700000000",
    "quality_rating": "GREEN"
  }
]

Field	Type	Description
`id`	string	The Meta phone number ID. Use this as `phone_number_id` in all other requests.
`display_name`	string	The display name shown in WhatsApp
`phone_number`	string	The E.164 formatted phone number
`quality_rating`	string	`GREEN`, `YELLOW`, or `RED`

Always use the id field (not the phone number itself) when referring to a phone number in other API calls such as listing templates or sending messages.