Menu

Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Global Phone Numbers Catalog

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 /AvailablePhoneNumbers and /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 preview.twilio.com/Numbers/.
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!

REST API Rerference Documents

/AvailableNumbers

The new /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

The new /ActiveNumbers endpoint replaces the old /IncomingPhoneNumbers resource. This new resource provides the same rich metadata that /AvailableNumbers provides, and the same filterable funtionality.

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.

Loading Code Sample...