Phone ID - Identity attributes: Subscriber Status

📘

NOTE:

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

The Subscriber Status identity attribute allows you to provide an end-user phone number and receive their current carrier subscriber status (prepaid or postpaid; active, suspended, deactivated; account type; primary account holder; length of account tenure) to better understand their value or risk. Information returned by Subscriber Status may vary by carrier or geographical market, please contact our Customer Support Team for additional information.

Information returned by Subscriber Status

• account_type - Whether the account is for an individual or an organization.
• account_tenure_max - The maximum amount of time in months the subscriber may have had their account (carriers often provide a range rather than a specific number of months). This may not come back in every response.
• account_tenure_min - The minimum amount of time in months the subscriber may have had their account (carriers often provide a range rather than a specific number of months). This may not come back in every response.
• primary_account_holder - Whether the phone number is the primary phone number of the account or not.
• account_status - Whether the account is active or not.
• contract_type - Whether the account is post-paid or pre-paid
• status - Contains properties explaining the processing status of your request.
• account_activation_date - The date the account was activated. It may not come back in every response.

Example request and response for Subscriber Status

Request

POST https://rest-ww.telesign.com/v1/phoneid/15555551212 HTTP/1.1
Authorization: Basic 12345678-9ABC-DEF0-1234-56789ABCDEF0:vjE/ZDfPvDkuGNsuqCFFO4neYIs=
Date: Thu, 18 Jan 2024 14:11:09 GMT
Content-Type: application/json 
{  
        “addons”: {
            “subscriber_status”: {}
        }
}

Response (partial)

"subscriber_status": {
        "status": {
            "code": 2800,
            "description": "Request successfully completed"
        },
        "account_type": "business",
        "contract_type": "postpaid",
        "account_status": "active",
        "primary_account_holder": false,
        "account_tenure_min": null,
        "account_tenure_max": null,
        "account_activation_date": "2024-01-15T00:00:00Z"
}

Subscriber Status request parameters

Subscriber Status response