Level up your Twilio API skills in TwilioQuest, an educational game for Mac, Windows, and Linux. Download Now


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?

Your Phone Numbers and Regulatory Compliance: Important Milestones

All references to “phone numbers” below refer to Twilio phone number types requiring regulatory compliance (RC) information (such as address and/or identity documentation). Note that approximate timeframes for important milestones are included below and will be updated as dates are finalized.

July 30, 2019

  • For existing phone numbers
    • Existing phone numbers in your current inventory should have been brought into compliance. If you have not already taken this necessary action, your phone numbers are at risk of being reclaimed due to ongoing carrier and regulatory enforcement activity. Twilio will not proactively reclaim phone numbers that are out of compliance at this time, except where forced to do so by regulators or carriers. We strongly urge all our valued customers to prioritize bringing all existing phone numbers into compliance if you haven't already done so.
  • For new phone numbers provisioned in Console
    • Provisioning new phone numbers through the Twilio Console requires you provide the needed regulatory information as outlined here for each phone number type. We will review submitted documents and information within 3 business days.
  • For new phone numbers provisioned through the existing API
    • There is no change in behavior to the API. You must subsequently upload required regulatory documents and information via the Twilio Console or with the RC Pilot APIs.
  • New Regulatory Compliance (RC) APIs are available in Pilot (request access using this form)
    • Using our new APIs, you will be able to programmatically submit and manage RC information for your Twilio phone numbers completely through this single API set.

August 6, 2019

  • Full walkthrough of our RC Intelligence Platform
    • The Twilio Phone Numbers Product Team will walk through our new RC Platform in a public talk at the SIGNAL Conference in San Francisco, highlighting the new APIs and timeline. This talk will be recorded and made available to anyone not able to attend SIGNAL, shortly after the event.

August 20, 2019

  • For new phone numbers provisioned through the existing API
    • We will disallow blank addresses between 12:00 a.m. and 3:00 a.m. Pacific Time (PDT) for newly provisioned regulated phone numbers. This action is to alert those who are failing to provide addresses when provisioning new phone numbers via the API. If you would like to be exempted from this brownout, please notify us here.
    • Note that this brownout was originally scheduled for August 12 and has been pushed back to allow you additional time to request to be exempted from the brownout and avoid potential disruption.

September 10, 2019

  • For new phone numbers provisioned through the existing API
    • Address requirements will be enforced via the API, provided through an AddressSid. This means you will be required to provide addresses for newly provisioned regulated phone numbers. API calls to provisioned phone numbers that do not submit a valid address will fail with error code 21631.
    • Note this was originally planned for August 26 and has been delayed in order to provide sufficient time for you to make the necessary changes to your application(s) after the August 20 brownout.

Mid-September through October 2019

  • V2 APIs will move from “Pilot” to “Beta.” The Pilot V2 API will be deprecated.
    Documentation regarding this change will be linked here when available.
  • If you are a new customer, you will need to send all RC-required documents when provisioning a new phone number (i.e,. “IdentitySid” required in /IncomingPhoneNumbers).

November 2019

  • The V2 API will move from “Beta” to “Generally Available.” Applications written using the Beta API will automatically use the Generally Available API.

December 2, 2019

  • For new phone numbers provisioned through the existing API
    • You will be required to submit proper documents when provisioning a phone number via the API. The API will require a valid IdentitySid when provisioning phone numbers that require identity information and documentation.


  • We will continue to review phone number data looking for missing or inaccurate information. We will notify you when action needs to be taken or information needs to be reviewed on your phone numbers. Twilio is committed to helping you meet the governmental and industry regulatory requirements for phone number provisioning and usage.
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 browsing the Twilio tag on Stack Overflow.