API Reference

List Available Phone Numbers (Public)

get
https://api.phone.com/v4/public/phone-numbers/available

Get a list of available phone numbers (public endpoint)

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer
≥ 0
Defaults to 0

The number of items to skip before starting to collect the result set

integer
1 to 500
Defaults to 25

The number of items to return

string
enum

Sort response

Allowed:
string

City filter

string

Country filter (code like "US" or "CA")

string

Country Code filter (like "1" or "972")

string

Toll free filter (1 for toll free numbers only, 0 for local numbers only)

string

NANP NPA filter (+1-NPA-nxx-xxxx)

string

NANP NXX filter (+1-npa-NXX-xxxx)

string

Phone Number filter. You can also provide value as "contains:1234" (numbers with "1234" will be returned)

string

Price filter. You can provide the exact price in cents or use operators like "lte:", "gte:", "lt:", "gt:", "between:".

string

State or Province (code like "NY", "CA" or "TX")

string

NANP XXXX filter (+1-npa-nxx-XXXX)

string

Phrase for AI-based numbers search

string

Percent of Toll free numbers in the output (0-100). Requires "npa" or "description" filters to be defined.

string
enum
Defaults to full

Defines mode of the data output (brief or full)

Allowed:
Responses

Updated 6 months ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 6 months ago