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

You must have your Technical Account Manager enable this feature for use. The addons parameter allows you to receive information returned from your enabled identity attributes.

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.


Did this page help you?