Purchasing Numbers

This article describers to process of obtaining numbers through Telnyx

Dillin avatar
Written by Dillin
Updated over a week ago

Acquiring numbers through Telnyx couldn't be easier! Global numbers at your finger tips.

This article describes the in-depth process on how to leverage our different search mechanisms, adding numbers to the cart and reviewing orders after purchase!

We've recently released a new user interface for our number search which you can read about here.

Video Walk-through for Searching and Purchasing a Phone Number

Kindly take note that the walkthrough video does not showcase the newly enhanced Number search feature. Instead, it showcases the older version of the number search. To access the older interface, you can toggle the "Try Improved Search" option off, located at the top right corner of the Search & Buy numbers tab.


The Numbers Section is where you can search, purchase, review orders and located on the left hand side of the portal.

Click on this button below and it will directly get you to the Numbers page.

Step by Step Guide to Searching, Purchasing & Ordering Phone Numbers (DID's)

Initially, you'll be brought to our number search section where you can leverage 4 different search types to cater for your requirements.

Users can search for local numbers or toll free numbers

Local Numbers

You can choose a search type of either Area Code or Region.

Area Code:

Searching area code allows you to specify the country code and area code you are interested in, along with the feature set you want your numbers to have - such as voice, messaging or fax capabilities.


Searching allows you to search for the country, state or city you are interested in, along with the feature set you want your numbers to have - such as voice, messaging or fax capabilities.

Toll Free Numbers

Choose a country of your choice and specify patterns that the toll free numbers should contain.

Click the advanced search dropdown in order to be able to search for more specific patterns of the phone numbers you'd like. We also include the ability to specify how many consecutive numbers you'd like as well as increase your results limit. At this moment in time, the results limit can only return up to 100 numbers.

Select more filters to have the ability to enable best effort searches so we can return numbers in a rate center or area code close to the one you've chosen - should we not be able to find any that meet your criteria.

Enable quickship to return a list of Toll Free numbers that have their voice/fax capabilities instantly provisioned so you can start to receive inbound calls immediately!

Enable reservable numbers in order to take advantage of numbers you'd like to reserve for future purchase. Using the Telnyx Number Reservations service you can reserve numbers for 30 minutes. You can also extend your reservations for another half hour, all without purchasing a single number. Now you can hold on to Telnyx numbers for free while deciding which ones you would like to order!

Exclude held numbers provides the user with the ability to return searches for numbers that they have not previously owned. By default, if you've recently deleted a number and search for a similar number - Telnyx will return the deleted number as a result. We hold deleted numbers on your account for up to 15 days before they are vetted and released back into the general inventory. If you do not want to retrieve recently deleted numbers, please enable "Exclude held numbers".

How do I restore or repurchase my deleted numbers?

As mentioned above, for any numbers you have deleted you have 15 days to repurchase the numbers back onto your account. Numbers deleted will incur charges again, through activation and a pro-rated monthly recurring charge depending on what date through the new month you've purchased it on. You can simply use our advanced search on our number search page to restore the deleted numbers to your account again. If you are unable to see them in your search results, and it's been less than 15 days since you deleted the number, please email numbering@telnyx.com so they can help verify and assist with the number restoration.

Number Ordering

Once you are happy with your number choice, click the "+ Add to Cart" button on the right.

When you're ready to purchase the numbers, follow the red arrow to view your cart on the top right of your account.


In your cart, you'll be able to see the numbers you've added and can still remove them by clicking the trash icon. Conveniently, you are able to select a connection and messaging profile you'd like these numbers to be assigned to automatically - once the order is processed.

We show you the upfront (one time activation) and monthly recurring cost for each number. On the right, you'll see your order summary and can then proceed by clicking the "Place Order" button. The order total will then be deducted from your balance. Orders are generally final and we do not provide refunds if you purchased a number by mistake. Please make sure to review the order summary completely before proceeding.

We also recommend ordering up to 100 numbers at a time through the cart. Orders over this amount may result in purchase failures (which you are not charged for) or connections/messaging profiles not being assigned correctly. We're continuously working on improving the scale of our ordering and assignment system.


After you have placed your order, you will be brought to the orders page.

Click on this button below and it will directly get you to the orders page.

Each order you've ever processed through our system will be listed here. You'll see the order date and time, along with the quantity of numbers purchased per order. Additionally, you can click the order id or "details" to re-check your order and verify what numbers were purchased.

International Requirements

When ordering numbers outside of North America, you may be prompted to provide more information to comply with local regulatory requirements by a set deadline. You can find a list of requirements for each country here.

Numbers that require further documentation will be displayed with a warning note on your portal.

This information can be added in the ‘Requirements’ section of your order as shown in the image below.
Requirements can generally include but are not limited to :
- End user information
- Phone numbers
- Proof of business

You will also be able to communicate directly with our Numbering team if any other information is required.

Please note : Any number without proper documentation uploaded may not be activated and inbound call capabilities may not work as expected.

Our engineers are working on better filtering so you can locate orders that you need to review, in the near future.

Additional Guides to Searching, Purchasing & Ordering DIDs

For more information on our numbers page, see this article.

For more information on our porting section, please see this collection.

Can't find what you're looking for? Click the chat bubble at your lower right-hand corner and talk to the support team!

Did this answer your question?