Skip to main content
GET
/
v1
/
whatsapp
/
numbers
Lista los números de WhatsApp Business conectados a la company.
curl --request GET \
  --url https://api.keebai.com/v1/whatsapp/numbers \
  --header 'Authorization: Bearer <token>'
{}
Returns the WhatsApp Business numbers connected to the company in a lightweight shape. It’s a projection of GET /channels?type=whatsapp optimized for flows where you only need Meta identifiers. 
GET /v1/whatsapp/numbers
Required scope: channels:read

​
Request

curl https://api.keebai.com/v1/whatsapp/numbers \
  -H "Authorization: Bearer kbai_pk_xxx"

​
Response 200

{
  "data": [
    {
      "id": "1234567890",
      "phone_number": "+56987654321",
      "waba_id": "9876543210",
      "channel_id": "ch_01HXYZ...",
      "status": "active"
    }
  ]
}
FieldTypeDescription
idstringMeta’s phone_number_id. Use it in POST /v1/messages (from_phone_number_id) when you have more than one number.
phone_numberstringNumber in E.164 format.
waba_idstringMeta’s WhatsApp Business Account id.
channel_idstringKeebai channel id. Same one that appears in /v1/channels.
statusenumactive | paused | disconnected.

​
Typical use cases

Sender number picker

Your integration has several numbers (e.g. Chile, Mexico, Peru). List whatsapp/numbers and show a dropdown to the user.

Validate before sending

Before a bulk send, check that the configured phone_number_id is still active.

Map outgoing webhooks

When you receive a whatsapp.message.received with phone_number_id: X, you can map it back to a channel_id using this list cached locally.

Discoverability

Your provisioning CLI doesn’t know which numbers exist — list them at startup.

Authorizations

​
Authorization
string
header
required

Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.

Response

200 - application/json

The response is of type object.