Skip to content

Search for available Telnyx phone numbers

GET
/numbers/available
countryCode
required
string

ISO 3166-1 alpha-2 country code (e.g., US, CA)

features
string

Comma-separated

areaCode
string

National destination / area code filter

limit
number

Max results (default 10, max 50)

Successful response

Response for GET /numbers/available

object
numbers
required
Array<object>

One available number returned from search

object
phoneNumber
required

E.164

string
locality
string
administrativeArea
string
phoneNumberType

E.g. local, toll_free

string
features

E.g. sms, voice, mms

Array<string>

Bad Request

Unauthorized

Internal Server Error