Real Contact API verifies and grades phone numbers, emails, and addresses and delivers essential insights, including a phone activity score, line types, name matches for phone, email, and address, and phone and email contact grades.
Real Contact 1.1
URL Structure: https://api.trestleiq.com/1.1/real_contact?api_key=[insert_key]&name=[insert_name]&phone=[insert_phone]&email=[insert_email]&ip_address=[insert_ip_address]&address.street_line_1=[insert_street_line_1]&address.city=[insert_city]&address.state_code=[insert_state_code]&address.postal_code=[insert_postal_code]&address.country_code=[insert_country_code]
query Parameters
| name required | string The name of the person to search. Example: name=Jon Snow |
| business.name | string The business name to search. Example: business.name=The Golden Company |
| phone required | string The phone provided by the lead on the web form. Example: phone=4259853735 |
string The email provided by the lead on the web form. Example: email=kushal.shah@gmail.com | |
| ip_address | string The IP address from which the lead signed up on the web form. Example: ip_address=192.0.0.1 |
| address.street_line_1 | string The first line of the street part in the structured address. (Cannot be longer than 1000 characters.) Example: address.street_line_1=100 Syrws St |
| address.city | string The name of the city in the structured address. (Cannot be longer than 500 characters.) Example: address.city=Lynden |
| address.state_code | string The state code of the structured address. (Cannot be longer than 100 characters.) Example: address.state_code=WA |
| address.postal_code | string The postal code of the structured address. (Cannot be longer than 100 characters.) Example: address.postal_code=98264 |
| address.country_code | string <ISO-3166-2> The ISO-3166 alpha-2 country code of the address. See: ISO-3166. (Cannot be longer than 100 characters.) Example: address.country_code=US |
| add_ons | string Request parameter to enable specific add-ons available for this endpoint. Add-ons incur additional charges. Please see here for more details.
Example: add_ons=litigator_checks,email_checks_deliverability |
Successful real contact response.
Response Schema: application/json
Bad Request: Indicates that the server cannot process the request due to client-side errors.
- Invalid API Key: Indicates that the API key is either incorrect or has been deactivated.
- API Key Missing: Indicates that your request did not include an API key.
- API Key Expired: Indicates that the API key has expired.
Too Many Requests: API Key has exceeded its rate limit.
Internal Server Error: Indicates that the server encountered an unexpected error.
- cURL
- JavaScript
- Node.js
- Python
- C#
- Go
- PHP
- Java
curl --location --request GET 'https://api.trestleiq.com/1.1/real_contact?name=Waidong+L+Syrws&phone=2069735100&address.city=Lynden&address.country_code=US&address.postal_code=98264&address.state_code=WA&address.street_line_1=100+Syrws+St&email=wsyrws@gmail.com&ip_address=192.0.0.1&add_ons=litigator_checks' \ --header 'x-api-key: [insert_api_key]' \ --header 'Accept: application/json'
- 200
{- "phone.is_valid": true,
- "phone.activity_score": 57,
- "phone.line_type": "Mobile",
- "phone.name_match": true,
- "phone.contact_grade": "A",
- "email.is_valid": true,
- "email.name_match": true,
- "email.contact_grade": "B",
- "address.is_valid": true,
- "address.name_match": true,
- "add_ons": {
- "litigator_checks": {
- "phone.is_litigator_risk": true
}, - "email_checks": {
- "email.is_deliverable": false
}
}, - "error": {
- "name": "InternalError",
- "message": "Could not retrieve entire response"
}, - "warnings": "Missing Input"
}