Search and Buy 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 walk-through 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.

Number Search dashboard

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 region allows you to search for the city, locality, rate center or country you are interested in, along with the feature set you want your numbers to have - such as voice, messaging or fax capabilities.

State / Province:

Searching state / province allows you to search for the state or province you are interested in (US only for now), 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.

Toll Free Numbers dashboard

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".

Number Ordering

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

Number Ordering dashboard

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.

Number orders with order summary

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.

Active number orders

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.

How do I delete a number?

Visit the my numbers page and use the search filters to filter for the number you want to delete. For each row of number that is displayed, on the right hand side under-neath the actions column, you will see a bin icon as seen in the below picture.

Number deletion icon in the My Numbers section

When you click this icon, a pop up will display asking for you to confirm that you are happy to delete the number, as seen below.

Delete Number button

Once a number is deleted, monthly recurring charges will no longer apply.

How do I restore or repurchase my deleted numbers?

For numbers you have deleted you have 15 days to repurchase the numbers back onto your account. Numbers deleted will incur charges again, and re-submission of documentation if they are international numbers, 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.

In the picture below, you want to specify the search type as area code, specify the country code and enter in the area code of the number. Then click the advanced search dropdown and set the phone number filter to "contains" and specify the remainder length of the number without spaces. Then click the green "search numbers" button.

You may have to wait a couple of minutes after deleting the number for the number to return as a search result.

Number search section

If you are unable to see the delete numbers in the search results, and it's been less than 15 days since you deleted the number, please email so they can help verify and assist with the number restoration.

For bulk deletes of numbers, please consider using our API or follow this article.

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.

Numbers status and warning note popup

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.

Number requirements and communications

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.

Did this answer your question?