Phone ID - Identity attributes: Number Deactivation

📘
NOTE:
To add this feature to your account, contact a Telesign expert. This feature is available for full-service accounts only.

The Number Deactivation identity attribute allows you to find out whether a phone number has been deactivated, when it was deactivated, and by which carrier the phone number was deactivated based on carriers' phone number data and Telesign's proprietary analysis. This information is returned in addition to the standard Phone ID information.

The information returned includes:

Carrier: The name of the carrier which deactivated the phone number most recently.
Last Deactivated Timestamp: When the phone number was last deactivated.
Tracking-since Timestamp: The date and time when the phone number started being tracked for number deactivation events.
Recycled: Whether the number has been recycled since the last verified date you provide. Only returned if you include the last_verified parameter in your request.

Examples

Example 1: Success

Request

POST https://rest-ww.telesign.com/v1/phoneid/15555551212 HTTP/1.1
Authorization: Basic 12345678-9ABC-DEF0-1234-56789ABCDEF0:vjE/ZDfPvDkuGNsuqCFFO4neYIs=
Date: Thu, 12 Oct 2017 14:11:09 GMT
Content-Type: application/json
{
    "addons": {
        "number_deactivation": {
            "last_verified": "2018-04-05T00:00:00Z"
        }
    }
}

Response (body only)

{
  "number_deactivation": {
    "carrier_name": "Verizon",
    "last_deactivated": "2018-04-06T00:00:00Z",
    "status": {
      "code": 2800,
      "description": "Request successfully completed"
    },
    "tracking_since": "2014-10-06T00:00:00Z",
    "recycled_since_last_verification": "recycled"
  }
}

Example 2: Failure

Request

POST https://rest-ww.telesign.com/v1/phoneid/15555551213 HTTP/1.1
Authorization: Basic 12345678-9ABC-DEF0-1234-56789ABCDEF0:vjE/ZDfPvDkuGNsuqCFFO4neYIs=
Date: Thu, 12 Oct 2017 14:11:09 GMT
Content-Type: application/json
{
  "addons": {
    "number_deactivation": {
      "last_verified": "2018-04-05T00:00:00Z"
    }
  }
}

Response (body only)

{
  "number_deactivation": {
    "status": {
      "code": 2603,
      "description": "Phone number out of number_deactivation identity signal coverage."
    }
  }
}

Schema

Number Deactivation request parameters

Parameter	Type	Description	Example
addons	object	The addons parameter allows you to receive information returned from your enabled identity attributes. Contact our Customer Support Team to add this feature.
addons.number_deactivation	object	Initiates use of the Number Deactivation identity attribute and contains inputs for it as sub-properties.
addons.number_deactivation.last_verified	string	The last date and time you successfully verified this user's identity. If this parameter is included, the response includes additional sub-properties within the number_deactivation package. The value must be formatted according to the ISO-8601 standard.	2018-04-05T00:00:00Z

Number Deactivation response

Property	Type	Description	Example
reference_id	string	A 32-digit hex value used to identify the web service requests. The value is unique to each web service request, is randomly generated by Telesign.
phone_type	string	One of the phone type codes.
description	string	Text describing the phone type.
number_deactivation	object	Contains sub-properties related to the Number Deactivation identity attribute. Only present if this identity attribute is enabled for your account and included in your request.
number_deactivation.carrier_name	string	The name of the current carrier for the phone.	Verizon
number_deactivation.last_deactivated	string	When the phone was last deactivated (if it was).	2016-04-05T00:00:00Z
number_deactivation.tracking_since	string	When the phone number first started being tracked for deactivation status.	2014-10-06T00:00:00Z
number_deactivation.status	object	Contains details about the delivery status of this package.
number_deactivation.status.code	integer	A status or error code describing what happened after your request.	2800
number_deactivation.status.description	string	A brief description of what the error or status code means.	Request successfully completed
number_deactivation.recycled_since_last_verification	string	Whether or not the phone number has been recycled since the time and date you provided. Only appears if you included a `last_verified` value in your request. Enumerated values: `recycled` `not_recycled` `cannot_be_determined`	recycled

📘NOTE:

Examples

Example 1: Success

Example 2: Failure

Schema

📘
NOTE: