Telnyx Numbers: Global Phone Numbers — Documentation Index
Global Phone Numbers documentation within the Numbers section of the Telnyx developer docs (https://developers.telnyx.com). Root index: https://developers.telnyx.com/llms.txt · Numbers index: https://developers.telnyx.com/development/llms/numbers-llms-txt.md · Full content for this subsection: https://developers.telnyx.com/development/llms/numbers-global-phone-numbers-llms-full-txt.md
Coverage
- Getting started with Telnyx phone number APIs: The following concepts must be understood to purchase phone numbers.
Searching
- Number search: Search the Telnyx phone number inventory for available local, toll-free, and international numbers by area code, country, features, or rate-center filters.
Ordering
- Number reservations: Reserve Telnyx phone numbers before purchase so they aren’t sold to another customer. Create, list, and release number reservations via the API or portal.
- Number orders: Step-by-step tutorial showing how to search inventory, create a number order, and provision phone numbers programmatically through the Telnyx API.
- Advanced Orders: Submit and track Advanced Order Requests when phone number searches return zero results - request Telnyx to acquire unavailable numbers on your behalf.
- Bulk orders: Order phone numbers in bulk by specifying quantity and search criteria without selecting specific numbers upfront
API Reference (Global Phone Numbers)
Country Coverage
- Get country coverage: Get country coverage
- Get coverage for a specific country: Get coverage for a specific country
Inventory Level
- Create an inventory coverage request: Creates an inventory coverage request. If locality, npa or national_destination_code is used in groupBy, and no region or locality filters are used, the whole…
Phone Number Search
numbers features
- Retrieve the features for a list of numbers: Retrieve the features for a list of numbers
Phone Number Reservations
- List number reservations: Gets a paginated list of phone number reservations.
- Create a number reservation: Creates a Phone Number Reservation for multiple numbers.
- Retrieve a number reservation: Gets a single phone number reservation.
- Extend a number reservation: Extends reservation expiry time on all phone numbers.
Phone Number Orders
- List number orders: Get a paginated list of number orders.
- Create a number order: Creates a phone number order.
- Retrieve a number order: Get an existing phone number order.
- Update a number order: Updates a phone number order.
- Retrieve a list of phone numbers associated to orders: Get a list of phone numbers associated to orders.
- Retrieve a single phone number within a number order.: Get an existing phone number in number order.
- Update requirements for a single phone number within a number order.: Updates requirements for a single phone number within a number order.
- List sub number orders: Get a paginated list of sub number orders.
- Retrieve a sub number order: Get an existing sub number order.
- Update a sub number order’s requirements: Updates a sub number order.
- Cancel a sub number order: Allows you to cancel a sub number order in ‘pending’ status.
- Create a sub number orders report: Create a CSV report for sub number orders. The report will be generated asynchronously and can be downloaded once complete.
- Retrieve a sub number orders report: Get the status and details of a sub number orders report.
- Download a sub number orders report: Download the CSV file for a completed sub number orders report. The report status must be ‘success’ before the file can be downloaded.
- Retrieve all comments
- Create a comment
- Retrieve a comment
- Mark a comment as read
Phone Number Block Orders
- List number block orders: Get a paginated list of number block orders.
- Create a number block order: Creates a phone number block order.
- Retrieve a number block order: Get an existing phone number block order.
Requirement Groups
Advanced Number Orders
Inexplicit Number Orders
- List inexplicit number orders: Get a paginated list of inexplicit number orders.
- Create an inexplicit number order: Create an inexplicit number order to programmatically purchase phone numbers without specifying exact numbers.
- Retrieve an inexplicit number order: Get an existing inexplicit number order by ID.
Callbacks
Phone Number Blocks Background Jobs
- Lists the phone number blocks jobs
- Retrieves a phone number blocks job
- Deletes all numbers associated with a phone number block: Creates a new background job to delete all the phone numbers associated with the given block. We will only consider the phone number block as deleted after all…
Phone Number Configurations
- List phone numbers
- Retrieve a phone number
- Update a phone number
- Delete a phone number
- Change the bundle status for a phone number (set to being in a bundle or remove from a bundle)
- Enable emergency for a phone number
- Retrieve a phone number with voice settings
- Update a phone number with voice settings
- Verify ownership of phone numbers: Verifies ownership of the provided phone numbers and returns a mapping of numbers to their IDs, plus a list of numbers not found in the account.
- Slim List phone numbers: List phone numbers, This endpoint is a lighter version of the /phone_numbers endpoint having higher performance and rate limit.
- List phone numbers with voice settings
CSV Downloads
Bulk Phone Number Operations
- Lists the phone numbers jobs
- Retrieve a phone numbers job
- Delete a batch of numbers: Creates a new background job to delete a batch of numbers. At most one thousand numbers can be updated per API call.
- Update the emergency settings from a batch of numbers: Creates a background job to update the emergency settings of a collection of phone numbers. At most one thousand numbers can be updated per API call.
- Update a batch of numbers: Creates a new background job to update a batch of numbers. At most one thousand numbers can be updated per API call. At least one of the updateable fields must…