GET /v1/numbers

List the WhatsApp numbers in your workspace.

Scope: numbers:read

curl https://api.msgpanda.com/v1/numbers -H "Authorization: Bearer $API_KEY"

{
  "numbers": [
    {
      "id": "36eeafaf-eb5f-436c-8a0d-153b5081a833",
      "display_phone": "+919900000000",
      "verified_name": "Northwind Traders",
      "mode": "new",
      "status": "active",
      "meta_phone_id": "100000539666669",
      "meta_waba_id": "100000539666668",
      "created_at": "2026-11-04T19:29:29+05:30"
    }
  ]
}

Field	Notes
id	Use this as number_id when sending
display_phone	E.164 as shown to recipients
status	active, paused or pending. Only active numbers can send
mode	new (created by Embedded Signup), coexistence (existing WhatsApp Business app number) or attach
meta_phone_id / meta_waba_id	Meta identifiers, useful for support tickets
waba_name	Display name of the owning WhatsApp Business Account
quality_rating	Meta's quality rating for the WABA (green, yellow, red or empty)
config_id	Embedded Signup configuration the number was onboarded with
registered_at	When Meta registration completed; null while the number is pending

A key bound to specific numbers sees only those numbers, and can only send from them.

Connecting numbers

Numbers are connected from the dashboard through Meta Embedded Signup: either a new number or an existing WhatsApp Business app number that keeps working in the app and gains API access. This is not scriptable through the machine API yet.