Rate this page:

Deactivated Phone Numbers

This resource lets you retrieve a list of United States phone numbers that have been deactivated by mobile carriers. These phone numbers are no longer in service for the subscriber who used to own that number. Twilio will update the set of available reports every day. These should be used periodically to remove these phone numbers from your opted-in subscriber list. For more information how to use these reports please see this FAQ.

Resource URI

All URLs in this documentation use the following base URL:

Fetching Deactivated Numbers

GET requests can be issued to /Deactivations to retrieve deactivated numbers.

Each request will retrieve the report for a single day. You should pass in a Date parameter (in YYYY-MM-DD format) to indicate what date's report you want to retrieve. Twilio will return a redirect to a url where you'll be able to retrieve that file.

There is only a single parameter on this request:

Parameters in REST API format
get date<iso8601> Not PII

The request will return a list of all United States Phone Numbers that were deactivated on the day specified by this parameter. This date should be specified in YYYY-MM-DD format.


        The response will return a signed url that will redirect you to where you can download the .txt of the deactivated numbers. This url will be valid for two minutes before expiring.

        Resource Properties in REST API format
        url Not PII

        Returns an authenticated url that redirects to a file containing the deactivated numbers for the requested day. This url is valid for up to two minutes.

        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 Community Forums or browsing the Twilio tag on Stack Overflow.


              Thank you for your feedback!

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

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

              Thanks for your feedback!

              Refer us and get $10 in 3 simple steps!

              Step 1

              Get link

              Get a free personal referral link here

              Step 2

              Give $10

              Your user signs up and upgrade using link

              Step 3

              Get $10

              1,250 free SMSes
              OR 1,000 free voice mins
              OR 12,000 chats
              OR more