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 attribute are 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. |