Fetch a list of all United States numbers that have been deactivated on a specific date.

GET /v1/Deactivations

A Deactivation resource to retrieve a list of United States phone numbers that have been deactivated by mobile carriers on a specific date.

Fetch a list of all United States numbers that have been deactivated on a specific date.

Query parameters

  • Date string(date)

    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.

Responses

  • 307 application/json

    Temporary Redirect

    Hide headers attributes Show headers attributes
    • Access-Control-Allow-Origin string

      Specify the origin(s) allowed to access the resource

    • Access-Control-Allow-Methods string

      Specify the HTTP methods allowed when accessing the resource

    • Access-Control-Allow-Headers string

      Specify the headers allowed when accessing the resource

    • Access-Control-Allow-Credentials boolean

      Indicates whether the browser should include credentials

    • Access-Control-Expose-Headers string

      Headers exposed to the client

    Hide response attribute Show response attribute object
    • redirect_to string(uri) | null

      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.

GET /v1/Deactivations
curl \
 --request GET 'https://messaging.twilio.com/v1/Deactivations' \
 --user "username:password"
Response examples (307)
{
  "redirect_to": "https://com-twilio-dev-messaging-deactivations.s3.amazonaws.com"
}