Skip to main content

​
Overview:

The following concepts must be understood to purchase phone numbers.

​
Coverage

Telnyx sells phone numbers in 100+ countries across multiple phone number types. To see a list of supported countries and number types, query the Get Country Coverage API. The response includes:
  • Countries
  • Available phone number types within each country
  • Applicable phone number attributes
  • If the inventory coverage API (inventory_coverage=true) is supported
If inventory coverage is supported, use the Inventory Coverage API to assess how many numbers are available based on your search criteria.

​
Regulatory Requirements

Prior to number activation, some phone numbers need additional information to satisfy regulatory requirements.  Requirement Resources
FeatureDescription
Compliance PageView regulatory requirements for all countries in the Telnyx Portal
Developer GuideGuide discussing regulatory requirements in more detail, including relevant API requests.
Requirement GroupsStores pre-filled regulatory information to be assigned to orders.
Search for available phone numbers using theList Available Phone Numbers API .  For a deeper dive into search strategies, check out the Search Guide.

​
Reserve

Reserve phone numbers to block other users from purchasing them. Reservations expire after 30 minutes. Not all phone numbers are reservable. 

​
Order

Purchase phone numbers using theCreate Number Order API . Numbers in the order must come from a prior search for the order to be accepted.

​
Advanced Order

Advanced Orders are a fallback mechanism for inventory not found in standard search. These requests are routed to the Number Operations team for manual sourcing and are added to the account upon acquisition. Submit anAdvanced Order and our Number Operations team will attempt to acquire the numbers you need. Once sourced, they’ll be added directly to your account for activation. These requests are best effort. Telnyx cannot guarantee that every advanced order will be fulfilled.