Search available numbers to purchase
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).
API key authentication - use your Zernio API key as a Bearer token
In: header
Query Parameters
"US"Number type; defaults to the country's WhatsApp-safe type
Area code
City
Pattern to match within the number
20value <= 100Response 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.searchAvailableWhatsAppNumbers();console.log(data);{
"country": "string",
"numberType": "string",
"numbers": [
{
"phoneNumber": "string"
}
]
}{
"error": "Unauthorized"
}List offerable number countries GET
The WhatsApp number countries available to purchase, each with its flat monthly price (cents), regulatory tier, whether it needs end-user KYC (Tier 3/4), and whether outbound calling is available (not BIC-blocked). Drives the country picker. Tier-4 countries appear only when enabled.
Submit regulated-number KYC POST
Submit the end customer's KYC (textual values, uploaded documents, address) for a Tier 3/4 country. Documents are streamed straight to the number provider and are not stored by Zernio. Builds + submits a regulatory requirement group and claims a pending_regulatory slot; the number is ordered + activated once the provider approves (asynchronous). Idempotent per (owner, country).