v2
latestOpenAPI 3.1.02026-08-075421692.0 MBPhone Numbers
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 returned areas (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.
get/v1/phone-numbers/availability
Query parameters
countrystring required
ISO-2 country code.
numberType'local' | 'mobile' | 'national' | 'toll_free'
Check a specific offered type (stock and address constraints are per type). Omitted = the country's default type.
smsboolean
Pass true when the buyer wants SMS: availability, areas, and areaOptions then describe the SMS-capable pool (an SMS purchase orders from it), not the wider voice-only pool.
Response
Availability + address constraint.