Menu

Core Concepts: Numbers

Twilio gives you instant access to different number types in over 100 countries for your voice and messaging applications. A Twilio number can include different communication capabilities such as voice, SMS, MMS, and fax. You can programmatically manage these numbers and build complex IVR apps and chatbots using Twilio's REST APIs.

Long Code or Direct-In-Dial (DID) Numbers

Direct Inward Dialing (DID) is a telephone service that allows call routing to a specific number at a business instead of going to a menu or a queue and dialing an extension. You can enable DID for your Twilio number by connecting your SIP infrastructure to a Twilio SIP Trunk or by registering your SIP endpoint on Twilio.

Long codes (which are 10-digit numbers in many countries) are meant for person-to-person communications, and can send 1 message per second. There are different concepts associated with a long code:

Local Numbers

Local numbers are numbers which are assigned to a specific geographic region. These numbers are typically used by individuals and local businesses. For Twilio's recommendations on filtering for "local" numbers, see Purchasing Twilio numbers that are local to customers.

National Numbers

National numbers are non-geographic long code numbers designed to be reachable from the entire country for the same price as a local phone call. Twilio offers national numbers in certain countries.

VoIP Numbers

VoIP (Voice over IP) numbers are virtual numbers that get allocated to a user instead of a dedicated phone line. A virtual number is a standard number that is not locked down to a specific phone. You can use these numbers to route voice calls or text messages to any phone or workflow.

Mobile Numbers

A mobile number refers to the 10-digit unique number that a wireless carrier uses to identify a mobile phone. Most countries (except for the US and Canada) assign a particular range for mobile numbers within the country’s numbering plan so they can be easily distinguished from local numbers.

Toll-free Numbers

Toll-free numbers are numbers with distinct, preassigned 3-digit codes in place of an area code. They are often used for domestic inbound calls and are free for your customers.

Domestic

Twilio's US and Canada toll-free numbers are enabled for sending and receiving SMS messages. While most toll-free numbers are domestically reachable and aren't reachable from pay phones, US toll-free numbers can be reached from Canada.

International

Twilio offers toll-free numbers in various international countries. See Twilio international number availability and their capabilities for more details on availability and toll-free features. For details on country requirements and limitations, see Toll-free number restrictions and limitations.

For a summary of different number types, see Phone Number Types and their Capabilities.

Long Code Procurement

You can use the Twilio Console or Twilio's REST APIs to manage provisioning, porting, and hosting your numbers with Twilio.

Provisioning

SIP Trunks connect IP-based communications infrastructure to the public switched telephone network (PSTN). Twilio's Elastic SIP Trunking uses the power of the cloud to bring instant provisioning, global reach (with local, national, mobile, and toll-free numbers in over 100 countries) and data-driven routing to the world of SIP Trunking. One way to procure a Twilio number is using the Twilio Console. Alternatively, you can use the Phone Numbers 2010-04-01 REST API resources to search for, purchase, and manage your Twilio long code numbers:

  • /AvailablePhoneNumbers: This API resource has specific subresources for you to search for local, toll-free and mobile numbers that are available to purchase. For a detailed walkthrough, see Using the REST API to Search for and Buy Numbers.
  • /IncomingPhoneNumbers: This resource represents a Twilio number provisioned from Twilio, ported to or hosted by Twilio. In order to provision a new number, you need to create an IncomingPhoneNumber resource.
  • /Addresses: This resource represents your or your customer’s physical location within a country. Around the world, some local authorities require the name and address of the user to be on file with Twilio to purchase and own a number. When searching for available numbers, address requirements are exposed as a property in the API response.
  • /RegulatoryCompliance: The Regulatory Compliance APIs include resources that help ensure you can provision and use phone numbers legally. Before creating a new Regulatory Bundle, you can review the requirements for a number based on its ISO country code, number type, and end user type (whether a number is owned by an individual or a business).

Porting

Porting is the transfer of a number between two telephone service providers on behalf of an end-user. The process involves providing the right documentation to prove ownership of the number as well as coordination between the existing provider and the new provider with regard to the number's porting date.

Port In

"Port in" is the process of porting your number from your current provider to Twilio. When a port request is submitted to Twilio, Voice and SMS capabilities for the numbers are ported by default. Twilio supports porting of US and international numbers. You may port your numbers into Twilio via the Console or the Porting API.

Port Out

"Port out" is the process of porting your number from Twilio to a new provider. The Twilio Console has a Port Away Requests page with links to relevant "port out" resources.

Further Reading: Porting help articles

Hosted SMS

Hosted SMS allows customers to use Twilio’s Programmable Messaging, Functions, and Studio products for sending and receiving SMS and MMS messages on voice-enabled numbers they already own as part of an established voice application. Twilio Hosted SMS supports USA & Canada in Beta.

Flex supports Hosted SMS via Flex Conversations. Hosted SMS is not available on Flex Legacy Messaging.

For a detailed guide on managing your Flex numbers, see Add and Configure a New Number with Twilio Flex.

Short Codes

A short code is a special 5 or 6 digit number that is shorter than a long code number. Short codes are used to send two-way SMS and MMS messages. There are two types of short codes:

  • Regular: Random short code assigned to you which you cannot review in advance.
  • Vanity: A specific short code that you choose. For example, "MyBiz".

Short Code Activation

Twilio currently offers short codes in many countries around the world (provisioning time varies by country). Twilio short codes can send 100 messages per second by default. You can raise this limit for an additional fee.

Activation and Migration to Twilio

Whether you're applying for a short code with Twilio or migrating one from an existing provider, you need to start a short code application. Because short codes can send high volumes of messages, wireless carriers individually approve every short code for its intended use. For more details, see the help articles on short codes.

Migration away from Twilio

For guidance on migrating your Twilio short code to a different provider, see Transferring a short code lease away from Twilio.

Free-to-end-user SMS

Free-to-End-User messaging (FTEU) is where the brand (the Twilio customer) pays the cost of sending an SMS to their end users. US short codes are the only way to send messages that are truly free to end users through Free-to-End-User messaging (additional fees and requirements apply). To learn how to programmatically send an SMS using a Twilio short code that you own, see the Programmable SMS Send Messages page.

Premium SMS

A Premium SMS number is a 3-7 digit number used for messaging that charges a premium price to the end user per sent SMS. Twilio does not support premium SMS for short codes as they have historically been used as a vector for fraud and abuse.

Sender IDs

A Sender ID is the name or number that identifies the sender of an SMS. This is defined by the "From" property of Twilio's Messaging resource. There are two types of Sender IDs:

Sender ID Activation

There are two ways to activate your Twilio sender ID:

  • Dynamic: This refers to instant provisioning of a Sender ID and applies to most Twilio supported countries.
  • Pre-registration: Some countries require pre-registration, which means the Twilio customer has to provide information and sometimes additional documents, resulting in additional time before the Sender ID is activated. These Sender IDs are known as "pre-registered". For pre-registering a sender ID, visit Twilio's pre-registration page.

Further Reading: International Support for Alphanumeric Sender ID

Caller IDs

Caller identification is a telephone service that transmits a caller's number to the called recipient when the call is being set up. In most cases, this will be the Twilio number or verified number used in the From parameter in your API request, or the callerId attribute of your TwimL <Dial> verb. For a detailed guide on addressing issues with caller identification, see Unable to Display a Business Name or Custom Text as Caller ID.

Regulatory Compliance

Twilio and its customers need to comply with local regulatory requirements for their numbers. Twilio has made it easy for businesses to review their country's regulations and submit the required information and documents for compliance. To get started with regulatory compliance, see the Twilio Console or the Regulatory Compliance APIs quickstarts.

Rate this page:

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 by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

Thank you for your feedback!

Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

Sending your feedback...
🎉 Thank you for your feedback!
Something went wrong. Please try again.

Thanks for your feedback!

thanks-feedback-gif