Skip to main content

​
Overview

The Telnyx Numbers API lets you search for available phone numbers, reserve them, and place orders — all programmatically. Below are the key concepts you need to understand before purchasing numbers.

​
Coverage

Telnyx sells phone numbers in 100+ countries across multiple phone number types (local, national, mobile, toll-free). To see a list of supported countries and number types, query the Get Country Coverage API. The response includes:
  • Countries and available phone number types within each country
  • Applicable phone number attributes
  • Whether 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

Some countries require additional documentation before phone numbers can be activated — for example, proof of address or business registration. Requirement Resources Search for available phone numbers using the List Available Phone Numbers API. You can filter by country, number type, city, area code, and features.
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.

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