Skip to contentSkip to navigationSkip to topbar
Rate this page:
On this page

GLOBAL PHONE NUMBERS CATALOG FAQ



FAQ - Global Phone Number Catalog

faq---global-phone-number-catalog page anchor

What is Twilio Announcing?

announcement page anchor

Twilio is announcing the Global Phone Numbers Catalog - a broader choice of phone numbers, available through the most powerful APIs in the industry. As we've grown our global coverage to offer phone numbers in over 100 countries, we've learned that numbers are not all created equal. In the past, we offered only numbers that could satisfy the broadest set of Twilio use cases. Today, with the Global Phone Numbers Catalog, we aim to offer not only the most feature-rich numbers but also those that best match the different needs of customers. We like to call these use case tailored phone numbers.


Where are the Docs?

docs page anchor

There are two new API endpoints being launched in conjunction with the Global Phone Number Catalog:

To search phone numbers available for purchase in the Catalog, use preview.api.twilio.com/Numbers/AvailableNumbers(link takes you to an external page).

To purchase, list, configure, and release phone numbers on a user account, use preview.api.twilio.com/Numbers/ActiveNumbers(link takes you to an external page).


Is this functionality supported in Console?

console page anchor

Not yet, we plan to launch Console support before going to Beta.


Who is the typical customer for the Catalog and APIs?

customers page anchor

All Twilio users can benefit from the broader selection of numbers and enhanced functionality of the new APIs. In particular, users that are not familiar with characteristics of phone numbers will benefit from the new use case based search functionality, to help them find numbers ideal for their use case. For example, a user looking for phone numbers for a contact center application, can pass the SavedSearch=twilio.use-case.contact-centers.voice to see numbers with characteristics suitable for that use case.


What functionality are you launching and when?

launch-schedule page anchor

The first release will be delivered in three phases:

Developer Preview: Support for new APIs that will allow search, purchase, list, configure, and release of numbers with support for attribute-based search functions, including use case based search. Catalog will include all the existing inventory of numbers available, plus Developer Preview numbers and new limited capability numbers.

Beta: Console support, including ability to create and save custom searches.

GA: Fully-featured version 1.0. Broader selection of use case tailored numbers, offering more choice and pricing options.


How do customers get access to the new API?

request-access page anchor

The API is currently in Developer Preview and new accounts are not being given access to the private resources. For more information, please visit Global Phone Numbers Catalog Twilio page.


How is the Global Phone Numbers Catalog different from our current inventory?

difference page anchor

The Catalog, searchable through the new APIs, will include all the inventory available through the existing APIs, plus: Developer Preview numbers, numbers previously held back due to their unique characteristics, and a limited group of premium numbers (high value, depleted prefixes: +1800, +1212, +44800).


Will the existing API be deprecated?

deprecated page anchor

No. The existing API endpoints (/AvailablePhoneNumbers and /IncomingPhoneNumbers) will continue operating as they do today. However, only fully featured phone numbers will be visible through /AvailablePhoneNumbers API.

The new Phone Numbers API will have full support for attributes and support a wider catalog of numbers. This new API will eventually support catalog search, number purchase, and porting/hosting order tracking.


How do I search/purchase/manage numbers in the Global Phone Numbers Catalog?

how-to-use page anchor

Through two new API endpoints. See the Docs /AvailableNumbers(link takes you to an external page) and /ActiveNumbers(link takes you to an external page).


What are Saved Searches?

saved-searches page anchor

Saved Searches give users a quick way to find numbers with specific characteristics, both in the Catalog, or in their account inventory. Twilio provides a set of predefined saved searches for the most common Twilio use cases: call tracking, contact centers, conversations, marketing, notifications, pbx-collaborations, and verifications. In a future release, users will be able to customize these searches, or create new ones, and save them to their account for convenience.

twilio.use-case.conversations.voice

twiliouse-caseconversationsvoice page anchor
PropertyDescription
Lifecyclegenerally-available
Type[local, mobile, tollfree, shortcode, shared-cost, machine-to-machine, voip, national]
Capabilities.Voice.InboundConnectivitytrue
Capabilities.Voice.OutboundConnectivitytrue
Capabilities.Voice.InboundReachabilityglobal
Capabilities.Voice.InboundCallerIdPreservationinternational
Capabilities.Voice.SipTrunkingtrue

twilio.use-case.conversations.sms

twiliouse-caseconversationssms page anchor
PropertyDescription
Lifecyclegenerally-available
Type[local, mobile, tollfree, shortcode, shared-cost, machine-to-machine, voip, national]
Capabilities.Sms.InboundConnectivitytrue
Capabilities.Sms.OutboundConnectivitytrue
Capabilities.Sms.InboundSenderIdPreservationinternational
Capabilities.Sms.InboundReachabilityglobal
Capabilities.Sms.Gsm7true
Capabilities.Sms.Gsm7Concatenationtrue
Capabilities.Sms.Ucs2true
Capabilities.Sms.Ucs2Concatenationtrue

twilio.use-case.verifications.voice

twiliouse-caseverificationsvoice page anchor
PropertyDescription
Lifecyclegenerally-available
Type[local, mobile, tollfree, shortcode, shared-cost, machine-to-machine, voip, national]
Capabilities.Voice.OutboundConnectivitytrue
Capabilities.Voice.InboundReachabilityglobal

twilio.use-case.verifications.sms

twiliouse-caseverificationssms page anchor
PropertyDescription
Lifecyclegenerally-available
Type[local, mobile, tollfree, shortcode, shared-cost, machine-to-machine, voip, national]
Capabilities.Sms.OutboundConnectivitytrue
Capabilities.Sms.InboundReachabilityglobal
Capabilities.Sms.Gsm7true
Capabilities.Sms.Ucs2true

twilio.use-case.notifications.voice

twiliouse-casenotificationsvoice page anchor
PropertyDescription
Lifecyclegenerally-available
Type[local, mobile, tollfree, shortcode, shared-cost, machine-to-machine, voip, national]
Capabilities.Voice.InboundConnectivitytrue
Capabilities.Voice.OutboundConnectivitytrue
Capabilities.Voice.InboundReachabilityglobal

twilio.use-case.notifications.sms

twiliouse-casenotificationssms page anchor
PropertyDescription
Lifecyclegenerally-available
Type[local, mobile, tollfree, shortcode, shared-cost, machine-to-machine, voip, national]
Capabilities.Sms.InboundConnectivitytrue
Capabilities.Sms.OutboundConnectivitytrue
Capabilities.Sms.InboundReachabilityglobal
Capabilities.Sms.Gsm7true
Capabilities.Sms.Ucs2true

twilio.use-case.marketing.voice

twiliouse-casemarketingvoice page anchor
PropertyDescription
Lifecyclegenerally-available
Type[local, mobile, tollfree, shortcode, shared-cost, machine-to-machine, voip, national]
Capabilities.Voice.InboundConnectivitytrue
Capabilities.Voice.OutboundConnectivitytrue
Capabilities.Voice.InboundCallerDtmftrue
Capabilities.Voice.inboundCalledDtmftrue
Capabilities.Voice.InboundReachabilityglobal
Capabilities.Voice.InboundCallerIdPreservationinternational

twilio.use-case.marketing.sms

twiliouse-casemarketingsms page anchor
PropertyDescription
Lifecyclegenerally-available
Type[local, mobile, tollfree, shortcode, shared-cost, machine-to-machine, voip, national]
Capabilities.Sms.InboundConnectivitytrue
Capabilities.Sms.OutboundConnectivitytrue
Capabilities.Sms.InboundReachabilityglobal
Capabilities.Sms.Gsm7true
Capabilities.Sms.Gsm7Concatenationtrue
Capabilities.Sms.Ucs2true
Capabilities.Sms.Ucs2Concatenationtrue

twilio.use-case.lead-tracking.voice

twiliouse-caselead-trackingvoice page anchor
PropertyDescription
Lifecyclegenerally-available
Type[local]
Capabilities.Voice.InboundConnectivitytrue
Capabilities.Voice.InboundCallerDtmftrue
Capabilities.Voice.inboundCalledDtmftrue
Capabilities.Voice.InboundReachabilityglobal
Capabilities.Voice.InboundCallerIdPreservationinternational
Capabilities.Voice.SipTrunkingtrue

twilio.use-case.lead-tracking.sms

twiliouse-caselead-trackingsms page anchor
PropertyDescription
Lifecyclegenerally-available
Type[local]
Capabilities.Sms.InboundConnectivitytrue
Capabilities.Sms.InboundSenderIdPreservationinternational
Capabilities.Sms.InboundReachabilityglobal
Capabilities.Sms.Gsm7true
Capabilities.Sms.Gsm7Concatenationtrue
Capabilities.Sms.Ucs2true
Capabilities.Sms.Ucs2Concatenationtrue

twilio.use-case.contact-centers.voice

twiliouse-casecontact-centersvoice page anchor
PropertyDescription
Lifecyclegenerally-available
Type[local, mobile, tollfree, shortcode, shared-cost, machine-to-machine, voip, national]
Capabilities.Voice.InboundConnectivitytrue
Capabilities.Voice.OutboundConnectivitytrue
Capabilities.Voice.InboundCallerDtmftrue
Capabilities.Voice.inboundCalledDtmftrue
Capabilities.Voice.InboundCallerIdPreservationinternational
Capabilities.Voice.SipTrunkingtrue
Capabilities.Voice.E911true

twilio.use-case.contact-centers.sms

twiliouse-casecontact-centerssms page anchor
PropertyDescription
Lifecyclegenerally-available
Type[local, mobile, tollfree, shortcode, shared-cost, machine-to-machine, voip, national]
Capabilities.Sms.InboundConnectivitytrue
Capabilities.Sms.OutboundConnectivitytrue
Capabilities.Sms.InboundSenderIdPreservationinternational
Capabilities.Sms.InboundReachabilityglobal
Capabilities.Sms.Gsm7true
Capabilities.Sms.Gsm7Concatenationtrue
Capabilities.Sms.Ucs2true
Capabilities.Sms.Ucs2Concatenationtrue

twilio.use-case.pbx-collaborations.voice

twiliouse-casepbx-collaborationsvoice page anchor
PropertyDescription
Lifecyclegenerally-available
Type[local, tollfree, voip]
Capabilities.Voice.InboundConnectivitytrue
Capabilities.Voice.OutboundConnectivitytrue
Capabilities.Voice.InboundCallerDtmftrue
Capabilities.Voice.inboundCalledDtmftrue
Capabilities.Voice.InboundCallerIdPreservationinternational
Capabilities.Voice.InboundReachabilityglobal
Capabilities.Voice.SipTrunkingtrue
Capabilities.Voice.E911true

Are there changes to pricing of phone numbers?

pricing-changes page anchor

Pricing of existing numbers in our inventory has not been affected. The new Phone Numbers API exposes a broader selection of numbers due to its ability to present numbers with differing capabilities. For some searches, this broader selection will result in multiple options available to users, likely at different price points. For example, a search for UK phone numbers for Marketing Alerts', might return both 2-way voice+sms mobile numbers and 1-way SMS-only numbers, at two different prices. Vanity numbers and numbers in depleted area codes are now also available and can be priced differently.


Rate this page: