Skip to main content
GET

Query Parameters

string
default:"US"
ISO-3166 alpha-2 country code. Examples: US, CA, GB.
string
default:"TollFree"
Number type. One of: Local, TollFree. Toll-free numbers do not require A2P 10DLC registration for US sending.
string
Filter local numbers by area code (e.g., 415). Only applies when type=Local.
boolean
default:"true"
Only return numbers with SMS capability.
boolean
Only return numbers with MMS capability. MMS is supported on US and CA numbers only.
string
Filter numbers containing a specific digit pattern (e.g., 555).
string
Filter by state/region code (e.g., CA for California). Only applies to local numbers.
number
default:"20"
Maximum number of results to return. Maximum: 20.

Response

AvailableNumber[]
Array of available phone numbers matching your criteria.
SMS messaging requires the Agent Pro plan or higher. The free plan includes smsMessaging access with 200 included credits per month.
Last modified on March 19, 2026