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.

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.

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

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

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.

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

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.

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.

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.

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

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.

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 numbering@telnyx.com 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.

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.

For more information on our numbers page, see this article.
​
For more information on our porting section, please see this collection.