Contact Plus

The Contact Plus add-on requires explicit consent from your end users, and once obtained, allows TeleSign to directly access a subscriber’s name and address on file with the carrier. The information included by this add-on is details about the subscriber who owns the phone 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 add-on, 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": "myla@xyz.com",
      "first_name": "MYLA",
      "last_name": "JONES",
      "state_province": "KY",
      "status": { 
         "code": 2800,
         "description": "Request successfully completed"
      },
      "zip_postal_code": "40509"
   },

}
Contact Plus Request Parameters
object
addons
object

You must have you Technical Account Manager enable this feature for use. The addons parameter allows you to receive information returned from Contact, Contact Plus, Contact Match, or Number Deactivation, depending on which add-ons you enable. You receive add-on information back along with standard PhoneID information.

Contact Plus Response
object
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

You will only see this in your response if you used the contact plus add-on.

This add-on provides the same response content as you would get back for the contact add-on, but the data is higher quality. If you want to see what is returned, refer to the contact add-on.