Fundamentals - Searching + Ordering Phone Numbers

​

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

​

Search

Search for available phone numbers using the List Available Phone Numbers API .  For a deeper dive into search strategies, check out the Number 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 the Create 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 an Advanced 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.