Skip to main content
GET
Lista los números de WhatsApp Business conectados a la company.
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.
Required scope: channels:read

Request

Response 200

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.