Telesign Number Deactivation
Overview
Number Deactivation supports inputting an end-user's phone number and retrieving information on whether the phone number has been deactivated, its deactivation date and the carrier that deactivated the number.
Country support
United States
User Inputs
International Phone Number
Acquired Attributes
| Acquired Attribute Name | Description |
|---|---|
| AcquiredDialcodeInternationalAddress | The address associated with the dial code of the inputted phone number. |
| AcquiredPhoneType | The type of phone. Possible values: MOBILE, FIXED_LINE, TOLL_FREE, VOIP, TOLL_FREE, PAGER, PAYPHONE, INVALID, RESTRICTED_PREMIUM, VOICEMAIL, PERSONAL, OTHER |
| AcquiredPhoneServiceProvider | The phone company or carrier for the phone number. Ex:"T-Mobile USA, Inc." |
| AcquiredDeactivatingPhoneServiceProvider | The name of the carrier which deactivated the phone number most recently. |
| AcquiredPhoneLastDeactivated | When the phone number was last deactivated. Ex: "2019-01-22T00:00:00Z" |
| AcquiredPhoneDeactivationTrackingSince | The date and time when the phone number started being tracked for number deactivation events. |
Assertions
| Assertion | Description |
|---|---|
| test.phoneLastDeactivated30Days | If AcquiredPhoneLastDeactivated is greater than or equal to 30 days before current date, the assertion will pass. Else, it will fail. |
| test.phoneLastDeactivated90Days | If AcquiredPhoneLastDeactivated is greater than or equal to 90 days before current date, the assertion will pass. Else, it will fail. |
| test.phoneLastDeactivated180Days | If AcquiredPhoneLastDeactivated is greater than or equal to 180 days before current date, the assertion will pass. Else, it will fail. |
Sample Response
{
"at_hash": "ploY5K5FltQWe4OSTXAgyR",
"sub": "abc",
"aud": "92ad7bec2f634653",
"endpoint": {
"status": "success",
"errorCode": "",
"errorDescription": "",
"idpType": "api",
"credential": "abc",
"credentialCreationDate": "10/02/2025 19:41:32 UTC",
"mbun": "vb67ad7b-63b9-49de-b102-7c17742cf842",
"maxToken": "9atFkuga2z54pZGWqFn_cYB2Ssr_4kFUjJoGls0u1-V",
"endpointInstanceList": [
{
"apikey": "aa86d485c5ff44d6",
"userAttributes": [
{
"attributeType": "InternationalTelephone",
"values": {
"dialCode": "1",
"telephone": "(617) 417-6554"
},
"dateCreated": "10/03/2025 14:40:29 UTC"
}
],
"acquiredAttributes": [
{
"attributeType": "DeviceType",
"values": {
"deviceType": "desktop"
},
"dateCreated": "10/03/2025 14:40:29 UTC"
},
{
"attributeType": "SubmissionTimestamp",
"values": {
"Timestamp": "03/10/2025 14:40:25"
},
"dateCreated": "10/03/2025 14:40:29 UTC"
},
{
"attributeType": "AcquiredDeactivatingPhoneServiceProvider",
"values": {
"deactivatingPhoneServiceProvider": "Verizon Communications Inc."
},
"dateCreated": "10/03/2025 14:40:29 UTC"
},
{
"attributeType": "AcquiredPhoneLastDeactivated",
"values": {
"phoneLastDeactivated": "2019-01-22T00:00:00Z"
},
"dateCreated": "10/03/2025 14:40:29 UTC"
},
{
"attributeType": "WorkflowTransactionStage",
"values": {
"Stage": "1"
},
"dateCreated": "10/03/2025 14:40:29 UTC"
},
{
"attributeType": "WorkflowTransactionStageAttempt",
"values": {
"Count": "1"
},
"dateCreated": "10/03/2025 14:40:29 UTC"
},
{
"attributeType": "AcquiredPhoneServiceProvider",
"values": {
"phoneServiceProvider": "T-Mobile USA, Inc."
},
"dateCreated": "10/03/2025 14:40:29 UTC"
},
{
"attributeType": "AcquiredPhoneDeactivationTrackingSince",
"values": {
"phoneDeactivationTrackingSince": ""
},
"dateCreated": "10/03/2025 14:40:29 UTC"
},
{
"attributeType": "AcquiredPhoneType",
"values": {
"phoneType": "MOBILE",
},
"dateCreated": "10/03/2025 14:40:29 UTC"
},
{
"attributeType": "AcquiredDialcodeInternationalAddress",
"values": {
"country": "US",
"sublocality": "",
"locality": "Cambridge",
"subpremise": "",
"sublocality_level_2": "",
"route": "",
"administrative_area_level_2": "Middlesex",
"premise": "",
"sublocality_level_5": "",
"administrative_area_level_3": "",
"sublocality_level_4": "",
"sublocality_level_3": "",
"administrative_area_level_1": "MA",
"street_number": "",
"neighborhood": "",
"postal_code": "02139"
},
"dateCreated": "10/03/2025 14:40:29 UTC"
}
],
"preferenceAttributes": [],
"userAssertionList": [
{
"provider": "Telesign",
"serviceOffering": "Telesign Phone ID - Number Deactivation",
"dateAsserted": "10/03/2025 14:40:29 UTC",
"assertions": {
"test.phoneLastDeactivated90Days": "pass",
"test.phoneLastDeactivated30Days": "pass",
"test.phoneLastDeactivated180Days": "pass"
}
}
],
"policyDecision": {
"conclusion": "deny",
"disposition": "negative",
"status": "success",
"selectedPolicyID": 4105903,
"decisionDetail": "{\"result\":{\"COMPONENT_8000027\":false,\"COMPONENT_8000027_CATEGORY\":\"verification\",\"Telesign_Phone_ID_Number_Deactivation_ServiceOffering\":[{\"assertions\":{\"test_phoneLastDeactivated180Days\":\"pass\",\"test_phoneLastDeactivated30Days\":\"pass\",\"test_phoneLastDeactivated90Days\":\"pass\"},\"dateAsserted\":\"10/03/2025 14:40:29 UTC\",\"provider\":\"Telesign\",\"serviceOffering\":\"Telesign Phone ID - Number Deactivation\"}],\"_approve\":false,\"_deny\":false,\"_retry\":false,\"approve\":false,\"default_action\":\"deny\",\"default_action_retries\":0,\"default_action_retry\":false,\"default_obligation\":null,\"deny\":true,\"disposition\":\"negative\",\"obligation\":null,\"policyID\":2105751,\"retryPolicyConfigDecisionIDs\":[],\"submission_count\":1,\"submission_count_attribute\":[{\"attributeType\":\"WorkflowTransactionStageAttempt\",\"dateCreated\":\"10/03/2025 14:40:29 UTC\",\"values\":{\"Count\":\"1\"}}],\"use_default\":true,\"version\":\"1.0.0\"}}"
}
}
]
},
"policyDecision": "deny",
"iss": "",
"exp": 1759434692,
"iat": 1759434092,
"jti": "ba60f54e-b5e8-4af2-8c00-01b5791235tm"
}Updated 6 days ago