Phone ID - Identity attributes: Contact Plus



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

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

addonsobjectThe 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_plusobjectFlag that initiates use of the Contact Plus identity attribute.y
addons.contact_plus.billing_postal_codestringThe postal code for the billing address of the contact you want information for.40509y

Contact Plus response

reference_idstringA 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_typestringOne of the phone type codes.
descriptionstringText describing the phone type.
contact_plusobjectContains 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.