Skip to main content
GET
Search Available Phone Numbers

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

country_code
string
default:US

ISO 3166-1 alpha-2 country code.

area_code
string | null

Restrict to one area code, e.g. 415.

number_type
enum<string>
default:local

The managed inventory is US local numbers only; toll_free currently returns 400.

Available options:
local,
toll_free
provider
string | null

Inventory to search. Only the managed twilio inventory (call-transfer support) is available; the parameter is kept so importing your own numbers can extend it later.

Allowed value: "twilio"

Response

Request fulfilled, document follows

available_phone_numbers
Available Phone Numbers · object[]
required

Inventory entries forwarded from the provider (number, region, pricing).