Phone ID - Identity attributes: Contact

The Contact identity attribute allows you to retrieve the name, address, and other contact info associated with the subscriber for the phone number you submit. This identity attribute offers fast identity verification with minimal user interaction.

Information returned

The information returned by this identity attribute includes:

• First Name
• Last Name
• Street Address
• City
• State (or Province)
• Country
• ZIP Code
• Email Address
• Input used (Only returned when Email ID is enabled.)

Email ID feature

The Email ID feature of the Contact identity attribute taps into mobile and email digital identity datasets, increasing its accuracy. Email ID allows you to compare the email provided by an end user during an activity like an onboarding flow with the email associated with the phone number.

📘

NOTE:

While the Contact identity attribute is available for both Full-service and Self-service customers, the Email ID feature is available for Full-service accounts only. It is only available in limited markets. Contact our Customer Support Team to obtain the latest information on supported markets and to enable Email ID for your account.

Example: Contact identity attribute

This is an example of using Phone ID with the Contact identity attribute.

Request

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

Response (body only)

{
  "contact": {
    "address1": "42 BAKER STREET",
    "address2": "",
    "address3": "",
    "address4": "",
    "city": "SEATTLE",
    "country": "",
    "first_name": "SHERLOCK",
    "last_name": "HOLMES",
    "state_province": "WA",
    "status": {
      "code": 2800,
      "description": "Request successfully completed"
    },
    "zip_postal_code": "98101",
    "email_address": "[email protected]"
  }
}

Example: Contact with Email ID feature enabled

This is an example of using Phone ID with the Contact identity attribute and Email ID enabled.

Request

POST https://rest-ww.telesign.com/v1/phoneid/15555551212 HTTP/1.1
Authorization: Basic 12345678-9ABC-DEF0-1234-56789ABCDEF0:vjE/ZDfPvDkuGNsuqCFFO4neYIs=
Date: Thu, 25 Jan 2024 14:11:09 GMT
Content-Type: application/json 
{
  "addons": {
    "contact": {
      "email": "[email protected]"
    }
  }
}

Response (body only)

{
  "contact": {
    "status": {
      "code": 2800,
      "description": "Request successfully completed"
    },
    "first_name": "SHERLOCK",
    "last_name": "HOLMES",
    "address1": "42 BAKER STREET",
    "address2": "",
    "address3": "",
    "address4": "",
    "city": "SEATTLE",
    "state_province": "WA",
    "country": "",
    "zip_postal_code": "98101",
    "email_address": "[email protected]",
    "input_used": "email"
  }
}

Request and response for the Contact identity attribute

Contact request parameters

Contact response