Skip to main content
GET
Telnyx Purchased Number List (Combined)

Authorizations

api_key
string
header
required

Headers

Company-Name
string
required

Schema name for multi-tenancy

Query Parameters

country_code
string
required

Country code for filtering phone numbers

Example:

"US"

number_slice
string

Custom substring used to match numbers (e.g. area code or prefix)

Example:

"21"

number_slice_filter
enum<string>

Filter type used for the number slice (e.g. 'first_part' or 'last_part')

Available options:
first_part,
last_part
Example:

"first_part"

Response

Purchased and available Telnyx numbers retrieved successfully

purchased_numbers
string[]

List of already purchased Telnyx numbers

available_numbers
string[]

List of available Telnyx numbers for purchase

is_masked
boolean

Indicates if numbers are partially masked for security or preview

Example:

false