Search and Buy Numbers

This article describes how to search and buy numbers in the Telnyx Mission Control Portal, leveraging different search mechanisms, adding numbers to the cart and reviewing your orders after purchase.

The My Numbers Section of Mission Control houses all of the phone numbers you've purchased or ported to Telnyx. You can access Search & Buy Numbers by clicking on the tab at the top of that page, or you can click on the Search Numbers Now! button below:

On the Search & Buy Numbers page, you will be provided with 5 search types:

Choose the country in the dropdown in which you want to find a phone number. This is the only required field when searching for a phone number.

Choose one or multiple features to ensure that the number you'll be purchasing is aligned with your use case:

Choose the number type you're looking to purchase:

Choosing Local Numbers enables you to search by Area Code, City/Region or State/Province:

Searching by area code allows you to search via the Area Code dropdown or to directly type in the area code that you're looking for.

Searching by City or Region enables you to type in the City, Region or Rate Center that you're looking for. While typing, the portal will autogenerate options for you to choose from:

Searching by State/Province allows you to search for the state or province you are interested in (US only for now). You can choose from the dropdown or type the state you're interested in:

Choose a country of your choice, choose Toll-free as the Type, and specify patterns that the toll-free numbers should contain under the Advanced Search feature:

You can use the Advanced Search feature for both the Toll-free and Local number types. This feature enables you to:

Happy with your search results? Click on the Add to Cart button to add your phone number/s to your cart for purchase"

When you're ready to purchase the numbers, scroll up and click on your cart in the top right-hand corner of the page:

Your number orders are accessible via your cart, showing the numbers you've chosen to purchase. You're able to empty your cart or individually delete a phone number by clicking on the trash icon associated with the number. You are also able to select a Connection or Messaging Profile you'd like these numbers to be assigned to automatically once the order is processed.

We show you the Upfront Cost (one-time activation) and Monthly Cost (recurring) for each number.

On the right, you'll see your Order Summary with the order total and the button to Place Order. The order total will be deducted from your balance.

Orders are 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 recommend only 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. If you'd like to order more than 100 phone numbers, please contact our sales team by clicking on the button below:

After you've placed your order, you will be brought 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. Find the number you'd like to delete and click on the trash icon on the right. Once a number is deleted, monthly recurring charges will no longer apply.

You have 15 days to repurchase numbers you may have accidentally deleted. Numbers deleted will reincur charges, and resubmission of documentation will be required if they're international numbers. A prorated monthly recurring charge will be applied depending on your repurchase date.

To restore the deleted numbers back to your account, use our Advanced Search on our Search & Buy Numbers Page:

You may have to wait a couple of minutes after deleting the number for the number to return as a search result. If you're unable to see the deleted 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.

Once purchased, head over to the Orders Page and click on the phone number you've purchased with the Pending status.

Clicking on that phone number takes you to the Orders Requirement page specific to that number where you can add the required documentation. Requirements can generally include, but are not limited to :

You may also start a conversation with our numbering team for any inquiries about documentation requirements for the phone number you purchased using the Communications functionality on the same page:

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