Documentation Index
Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt
Use this file to discover all available pages before exploring further.
Overview:
The following concepts must be understood to purchase phone numbers.
Coverage
Telnyx sells phone numbers in 100+ countries across multiple phone number types.
To see a list of supported countries and number types, query the Get Country Coverage API. The response includes:
- Countries
- Available phone number types within each country
- Applicable phone number attributes
- If 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
Prior to number activation, some phone numbers need additional information to satisfy regulatory requirements.
Requirement Resources
| Feature | Description |
|---|
| Compliance Page | View regulatory requirements for all countries in the Telnyx Portal |
| Developer Guide | Guide discussing regulatory requirements in more detail, including relevant API requests. |
| Requirement Groups | Stores pre-filled regulatory information to be assigned to orders. |
Search
Search for available phone numbers using the List Available Phone Numbers API .
For a deeper dive into search strategies, check out the 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 for the order to be accepted.
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.
