In the past nine years, we’ve worked with carriers around the globe to bring the power of programmable communications to phone numbers in over 100 countries. Over time, testing millions of numbers across an ever-increasing array of Twilio use cases, we learned what features our customers needed, and always strived to offer only numbers that met the broadest set of requirements. However, today, as our customers continue to innovate with new use cases, we believe the best product we can offer is not only one that satisfies all requirements but, more importantly, one that offers the best choices for the unique needs of every customer. We like to call these use case tailored phone numbers and they’re at the center of our new Twilio Global Phone Numbers Catalog.
With the Global Phone Number Catalog, you get instant access to the breadth and depth of the communication options that exist in the phone numbers market, such as one-way numbers ideal for outbound use cases, or dual-function landline numbers for customer support messaging use cases. Starting today, you can search our full inventory through a new Phone Numbers API that provides:
- A broader choice of phone numbers: Access our full suite of available phone numbers, featuring numbers tailored to specific use cases, such as unidirectional or premium numbers.
- More powerful search and management: Get the right options for your specific application with use case-based search and granular attribute filters.
- Rich phone number metadata: See every number’s detailed capabilities, geodata, regulatory requirements, and configuration, to help you effectively choose and manage your inventory.
The new API is independent of the existing
/IncomingPhoneNumbers endpoints. You can continue using both, however some new number types will only be visible via the new API, due to their unique characteristics.
Request access to the developer preview here, and once enabled, you can find the new endpoints at
You can find more detailed information in API Reference Docs. We’d love to hear your feedback... and we can’t wait to see what you build!
/AvailableNumbers resource lists all available numbers and is rich in number attributes that represent the capabilities of a phone number and how it interacts within Twilio's super network and programmable.
/ActiveNumbers endpoint replaces the old
/IncomingPhoneNumbers resource. This new resource provides the same rich metadata that
/AvailableNumbers provides, and the same filterable funtionality.