Telesign Subscriber Status
Overview
Subscriber Status supports inputting an end-user's phone number to receive their current carrier, subscriber status and length of account tenure to inform risk assessment.
Country support
United States
User Inputs
International Phone Number
Available 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." |
| AcquiredPhoneStatus | Whether an account is active, suspended, or deactivated. |
| AcquiredPhoneAccountMaxAgeMonths | The maximum amount of time in months the subscriber may have had their account. Ex: "24" |
| AcquiredPhoneAccountMinAgeMonths | The minimum amount of time in months the subscriber may have had their account. Ex: "12" |
Available Assertions
| Assertion | Description |
|---|---|
| test.phoneActive | Checks whether the account is currently active. If AcquiredPhoneStatus == active, assertion will pass. |
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": "12ad6bnk1f634629",
"userAttributes": [
{
"attributeType": "InternationalTelephone",
"values": {
"dialCode": "1",
"telephone": "(617) 417-6554"
},
"dateCreated": "10/02/2025 19:41:32 UTC"
}
],
"acquiredAttributes": [
{
"attributeType": "AcquiredPhoneAccountMaxAgeMonths",
"values": {
"phoneAccountMaxAgeMonths": ""
},
"dateCreated": "10/02/2025 19:41:32 UTC"
},
{
"attributeType": "DeviceType",
"values": {
"deviceType": "desktop"
},
"dateCreated": "10/02/2025 19:41:31 UTC"
},
{
"attributeType": "SubmissionTimestamp",
"values": {
"Timestamp": "02/10/2025 19:41:25"
},
"dateCreated": "10/02/2025 19:41:31 UTC"
},
{
"attributeType": "WorkflowTransactionStage",
"values": {
"Stage": "1"
},
"dateCreated": "10/02/2025 19:41:31 UTC"
},
{
"attributeType": "WorkflowTransactionStageAttempt",
"values": {
"Count": "1"
},
"dateCreated": "10/02/2025 19:41:31 UTC"
},
{
"attributeType": "AcquiredPhoneServiceProvider",
"values": {
"phoneServiceProvider": "T-Mobile USA, Inc."
},
"dateCreated": "10/02/2025 19:41:32 UTC"
},
{
"attributeType": "AcquiredPhoneType",
"values": {
"phoneType": "MOBILE"
},
"dateCreated": "10/02/2025 19:41:32 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/02/2025 19:41:32 UTC"
},
{
"attributeType": "AcquiredPhoneStatus",
"values": {
"phoneStatus": "active"
},
"dateCreated": "10/02/2025 19:41:32 UTC"
},
{
"attributeType": "AcquiredPhoneAccountMinAgeMonths",
"values": {
"phoneAccountMinAgeMonths": "12"
},
"dateCreated": "10/02/2025 19:41:32 UTC"
}
],
"preferenceAttributes": [],
"userAssertionList": [
{
"provider": "Telesign",
"serviceOffering": "Telesign Phone ID - Subscriber Status",
"dateAsserted": "10/02/2025 19:41:32 UTC",
"assertions": {
"test.phoneActive": "pass"
}
}
],
"policyDecision": {
"conclusion": "deny",
"disposition": "negative",
"status": "success",
"selectedPolicyID": 4105881,
"decisionDetail": "{\"result\":{\"COMPONENT_8000026\":false,\"COMPONENT_8000026_CATEGORY\":\"verification\",\"Telesign_Phone_ID_Contact_ServiceOffering\":[],\"Telesign_Phone_ID_Subscriber_Status_ServiceOffering\":[{\"assertions\":{\"test_phoneActive\":\"pass\"},\"dateAsserted\":\"10/02/2025 19:41:32 UTC\",\"provider\":\"Telesign\",\"serviceOffering\":\"Telesign Phone ID - Subscriber Status\"}],\"_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\":2105750,\"retryPolicyConfigDecisionIDs\":[],\"submission_count\":1,\"submission_count_attribute\":[{\"attributeType\":\"WorkflowTransactionStageAttempt\",\"dateCreated\":\"10/02/2025 19:41:31 UTC\",\"values\":{\"Count\":\"1\"}}],\"use_default\":true,\"version\":\"1.0.0\"}}"
}
}
]
},
"policyDecision": "deny",
"iss": "",
"exp": 1769434694,
"iat": 1769434094,
"jti": "ba60f54e-b5e8-4af2-8c00-01b5791235tm"
}Updated 6 days ago