Phone ID - Identity attributes: Contact Plus

❗️
WARNING
This product is deprecated.

The Contact Plus identity attribute requires explicit consent from your end user, and once obtained, allows Telesign to directly access a subscriber's name and address on file with the carrier. The information included by this identity signal is details about the subscriber who owns the device associated with the phone number:

First Name
Last Name
Street Address
City
State (or Province)
Country
ZIP Code
Email address

Consent for Contact Plus

In order to use the Contact Plus identity attribute, you must obtain explicit consent from your end users. In your application, create a message asking if it is okay to verify the end user's name, address, and mobile number with a mobile service provider. An example of the message might be 'You agree that we may verify your number in order to verify your identity, and you consent to having this information reviewed, disclosed, and compared for this purpose.' Another example might be to provide them with a written notice of your Terms and Conditions (including this request for consent) that reads 'I have read and agree with the Terms and Conditions, including the disclosure of my personal information about me by third parties for the purposes of identity verification.'

Example request and response for Contact Plus

POST request for Contact Plus

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": {
            "contact_plus": {"billing_postal_code": "40509"}
        }
}

Contact Plus response body

{
  "contact_plus": {
    "address1": "2432 CHIMNEY POINT LN",
    "address2": "",
    "address3": "",
    "address4": "",
    "city": "LEXINGTON",
    "country": "",
    "email_address": "[email protected]",
    "first_name": "MYLA",
    "last_name": "JONES",
    "state_province": "KY",
    "status": {
      "code": 2800,
      "description": "Request successfully completed"
    },
    "zip_postal_code": "40509"
  }
}

Contact Plus request parameters

Parameter	Type	Description	Example	Required?
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.		y
addons.contact_plus	object	Flag that initiates use of the Contact Plus identity attribute.		y
addons.contact_plus.billing_postal_code	string	The postal code for the billing address of the contact you want information for.	40509	y

Contact Plus response

Property	Type	Description
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, and is returned in the response message immediately following the web service request.
phone_type	string	One of the phone type codes.
description	string	Text describing the phone type.
contact_plus	object	Contains information returned by the Contact Plus identity attribute. This is the same response content you would get back for the Contact identity attribute, but the data is higher quality. See Phone ID - Identity attributes: Contact for more details.

❗️WARNING

Consent for Contact Plus

Example request and response for Contact Plus

❗️
WARNING