Skip to main content
POST
Search for available phone numbers to add to your account. Filter by area code, country, number type, and pattern matching.

Request Body

Send one of areaCode, state, city, or query. If none provided with just numberType, returns default US numbers.
string
3-digit area code to search in.Example: 604
string
2-letter US state or Canadian province code. Auto-detects Canadian provinces.Example: CA, NY, BC, ON
string
City name. Supports 40+ major US and Canadian cities.Example: vancouver, san francisco, new york
string
default:"local"
Number type: local or tollFree.
string
Legacy free-text search. Accepts area codes, city names, state codes, or canada/usa.
Returns up to 75 numbers per search (3 pages of 25 in the UI).

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.