Phone Numbers

Phone Numbers

A WhatsApp number is not a special kind of number. It is a phone number with WhatsApp enabled on it. Everything about the number itself (availability, pricing, buying, porting, KYC) is documented once under Phone Numbers and is not repeated here.

Two ways to get a WhatsApp number

1. Buy or port a number, then connect WhatsApp. Purchase a number (connectWhatsapp is on by default, so a plain purchase already starts the WhatsApp flow) or port one in, then run the connection flow. This provisions the number through Zernio and links it to your WhatsApp Business Account.
2. Bring your own number (Embedded Signup). Connect a number you already hold with your own carrier through Meta's Embedded Signup. See Connection & Setup.

Number status

Once a number is connected, read its live WhatsApp state straight from Meta: display name and approval, quality rating, messaging-limit tier, throughput, the official-business badge, connection status, and the owning Business Account's verification status. Useful for monitoring deliverability and limits.

const { data } = await zernio.whatsapp.getWhatsAppNumberInfo({
  query: { accountId: 'YOUR_ACCOUNT_ID' }
});
console.log(data.phone.quality_rating, data.phone.messaging_limit_tier);

response = client.whatsapp.get_whats_app_number_info(account_id='YOUR_ACCOUNT_ID')
print(response.phone.quality_rating, response.phone.messaging_limit_tier)

curl "https://zernio.com/api/v1/whatsapp/number-info?accountId=YOUR_ACCOUNT_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Verify the number with Meta

WhatsApp requires the number to be verified with Meta (a one-time OTP) before it can send. Request a code, then submit it.

# Step 1: Request the verification code
curl -X POST "https://zernio.com/api/v1/whatsapp/phone-numbers/PHONE_NUMBER_ID/request-code" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "SMS"}'

# Step 2: Submit the code
curl -X POST "https://zernio.com/api/v1/whatsapp/phone-numbers/PHONE_NUMBER_ID/verify" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code": "123456"}'

Related

• Phone Numbers - Buy, port, price, and KYC (canonical)
• Connection & Setup - Connect a WABA or bring your own number
• Calling - WhatsApp Business voice calling