Phone Numbers
Search Available Numbers
Search for available phone numbers to provision
POST
Search for available phone numbers to add to your account. Filter by area code, country, number type, and pattern matching.
Returns up to 75 numbers per search (3 pages of 25 in the UI).
Request Body
Send one ofareaCode, state, city, or query. If none provided with just numberType, returns default US numbers.
string
3-digit area code to search in.Example:
604string
2-letter US state or Canadian province code. Auto-detects Canadian provinces.Example:
CA, NY, BC, ONstring
City name. Supports 40+ major US and Canadian cities.Example:
vancouver, san francisco, new yorkstring
default:"local"
Number type:
local or tollFree.string
Legacy free-text search. Accepts area codes, city names, state codes, or
canada/usa.Response
array
Array of available phone numbers with details.
Number Object
string
The phone number in E.164 format.
string
Human-readable formatted number.
string
City or region for local numbers.
string
State or province code.
object
What the number supports:
voice, sms, mms.number
Monthly cost in USD.