Check country availability
Pre-purchase check, so you can warn BEFORE a customer invests in KYC (regulated review is async, 1-3 days). Tells you whether we have deliverable inventory, and what address the customer needs:
addressConstraint: geo→ the registered address MUST be in one of the returnedareas(the only place we have stock). A different-area address passes pre-approval but the number can never be assigned.addressConstraint: country→ any in-country address works.addressConstraint: none→ field-only / instant country, no address. Call this before starting the KYC form for regulated countries.
API key authentication - use your Zernio API key as a Bearer token
In: header
Query Parameters
ISO-2 country code.
Response Body
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.whatsappphonenumbers.checkWhatsAppNumberAvailability({ query: { country: 'string', },});console.log(data);{
"country": "string",
"numberType": "string",
"available": true,
"addressConstraint": "geo",
"areas": [
"string"
]
}{
"error": "Unauthorized"
}Search available numbers GET
Search the provider's inventory for numbers available to purchase in a country (default US). Optional filters narrow the results. The country must be offerable (see GET /v1/whatsapp/phone-numbers/countries).
Purchase phone number POST
Initiate purchasing a WhatsApp phone number. Payment-first flow: the user does not pick a specific number. The system either creates a Stripe Checkout Session (first number) or increments the existing subscription quantity and provisions inline (subsequent numbers). Requires a paid plan. The maximum number of phone numbers is determined by the user's plan.