Skip to main content
GET
/
1.0
/
real_contact
GET https://api.trestleiq.com/1.0/real_contact?name={name}&phone={phone}&email={email}

{
  "phone.is_valid": true,
  "phone.activity_score": 123,
  "phone.line_type": "<string>",
  "person.match_score": 123,
  "person.contactability_grade": "<string>",
  "address.is_valid": true,
  "email.is_valid": true,
  "ip_address.risk_score": 123
}

​
Overview

Real Contact API validates whether a lead is real, confirms the person is who he/she says they are, and grades the contactability of the lead.

​
Endpoint

GET https://api.trestleiq.com/1.0/real_contact?name={name}&phone={phone}&email={email}

​
Parameters

​
name
string
required
The name of the person to search. Example: John Doe
​
phone
string
required
The phone provided by the lead on the web form. Example: 4259853735
​
email
string
The email provided by the lead on the web form. Example: [email protected]
​
ip_address
string
The IP address from which the lead signed up on the web form. Example: 192.0.0.1
​
address.street_line_1
string
The first line of the street part in the structured address.
​
address.city
string
The name of the city in the structured address.
​
address.state_code
string
The state code of the structured address.
​
address.postal_code
string
The postal code of the structured address.
​
address.country_code
string
The ISO-3166 alpha-2 country code of the address.

​
Headers

​
x-api-key
string
required
Your API key for authentication.

​
Code Examples

curl --request GET \
  --url "https://api.trestleiq.com/1.0/real_contact?name=John%20Doe&phone=4259853735&[email protected]" \
  --header "x-api-key: YOUR_API_KEY"
Postman payload 
{
  "method": "GET",
  "url": "https://api.trestleiq.com/1.0/real_contact",
  "query": {
    "name": "John Doe",
    "phone": "4259853735",
    "email": "[email protected]"
  },
  "headers": { "x-api-key": "YOUR_API_KEY" }
}

​
Response

​
phone.is_valid
boolean
True if the phone number is valid.
​
phone.activity_score
integer
Trestle’s activity scores range from 0 to 100. A score of 70 or above means high confidence the phone is connected and active.
​
phone.line_type
string
The line type of the phone number.
​
person.match_score
integer
The match score indicating how well the provided information matches Trestle’s database.
​
person.contactability_grade
string
The contactability grade of the lead (A, B, C, D, F).
​
address.is_valid
boolean
True if the address is valid.
​
email.is_valid
boolean
True if the email is valid.
​
ip_address.risk_score
integer
Risk score associated with the IP address.