Data Dictionary

Reverse Phone API

Response Field
Description
ID
Trestle's persistent ID of the phone number/address/person returned.
Phone Number
The phone number normalized and formatted with a country code.
Is Valid
Boolean indicator if the phone is a valid number and assigned to a carrier.
Country Calling Code
The country code for the phone number.
Line Type
Line type indicating if the phone is landline, mobile, fixed or non-fixedVoIP (like Twilio or Google Voice), toll-free, etc.
Carrier
The MVNO level carrier provides the service to the subscriber.
Is Prepaid
Boolean indicator if the phone number is associated with a prepaid account.
Is Commercial
Boolean indicator if the phone number is registered to a business.
Owners
The owner(s) associated with the phone. For each owner, we provide details, including first, middle, and last names, alternate names, age and gender, person or business type, and phone link date.
Current Addresses
Current address of the subscriber, including full address, postal code, coordinates, and the date when the subscriber was associated with the address.
Emails
The list of emails associated with the owner of the phone.
Alternate Phones
A list of additional phone numbers associated with the subscriber along with their line type.

Reverse Address API

Response Field
Description
ID
Trestle's persistent ID of the phone number/address/person returned.
Is Valid
Boolean indicator if the address is valid and exists in the real world.
Normalized Address
Normalized and standardized address including street line, unit number (if applicable), city, postal, state, and country code.
Lat/Long
The coordinates of the normalized and validated address.
Is Commercial
Boolean indicator if the address is associated with a business.
Delivery Point
The delivery point of the address. This includes single unit, multi-unit, PO Box, etc.
Current Residents
The list of current people and/or businesses at the address.
Demographics
Age range and gender of the resident at the address.
Industry
If the address is registered to the business, this is the industry of the business (e.g., retail, automotive, etc.).
Link to Address Start Date
The date of when the resident has been associated with the address.
Phones
A list of phone numbers associated with the resident along with their line type.
Emails
The list of emails associated with the current resident.
Historical Addresses
A list of historical addresses associated with the resident, including full address, postal code, coordinates, and the dates of when the subscriber was associated with the address.
Associated People
Associated people living in the same household, as well as relatives of the resident.

Caller Identification API

Response Field
Description
ID
Trestle’s persistent ID of the phone number/address/person returned.
Phone Number
The phone number normalized and formatted with a country code.
Is Valid
Boolean indicator if the phone is a valid number and assigned to a carrier.
Country Calling Code
The country code for the phone number.
Line Type
Line type indicating if the phone is landline, mobile, fixed or non-fixed VoIP (like a Twilio or Google Voice), toll-free, etc.
Carrier
The MVNO level carrier that provides the service to the subscriber.
Is Prepaid
Boolean indicator if the phone number is associated with a prepaid account.
Is Commercial
Boolean indicator if the phone number is registered to a business.
Belongs To
The primary owner of the phone. In the case of family plans, additional owners associated with this phone are also provided in the associated_people attribute, categorized as ‘PotentialOwner’.
Age Range
Age range of the phone subscriber.
Gender
Gender of the phone subscriber.
Industry
If the phone is registered to the business, this is the industry of the business (e.g., retail, automotive, etc.).
Phone Link Date
The first date in which the phone was linked to the subscriber.
Current Addresses
Current address of the subscriber, including full address, postal code, coordinates, and the date of when the subscriber was associated with the address.
Emails
The list of emails associated with the primary owner of the phone.

Find Person API

Response Field
Description
Count Person
Count of persons that matched the query. Only up to 100 person details are provided as part of the API response.
ID
Trestle's persistent ID of the phone number/address/person returned.
Name
Full name of the person found including phonetic matched persons.
Demographics
Age range and gender of the person returned.
Found at Address
The address at which the person was found. This is especially needed if the search is at a city/state or state level.
Phones
A list of phone numbers associated with the person along with their line type.
Emails
The list of emails associated with the person.
Historical Addresses
A list of historical addresses associated with the person, including full address, postal code, coordinates, and the dates when the subscriber was associated with the address.
Associated People
Associated people living in the same household, as well as relatives to the person returned.

Phone Validation API

Response Field
Description
ID
Trestle's persistent ID of the phone number/address/person returned.
Phone Number
The phone number is normalized and formatted with a country code.
Is Valid
Boolean indicator if the phone is a valid number and assigned to a carrier.
Activity Score
A 0-100 score indicating whether a phone is connected and in active use or whether it is disconnected and has not seen any activity.
Country Calling Code
The country code for the phone number.
Country Code
The ISO-3166 alpha-2 country code of the phone number.
Country Name
The country name of the location associated with the phone number.
Line Type
Line type indicating if the phone is landline, mobile, fixed or non-fixed VoIP (like a Twilio or Google Voice), toll-free, etc.
Carrier
The MVNO level carrier that provides the service to the subscriber.
Is Prepaid
Boolean indicator if the phone number is associated with a prepaid account.

Real Contact API

Response Field
Description
Phone Is Valid
Boolean indicator if the phone is a valid number and assigned to a carrier.
Phone Activity Score
A 0-100 score indicating whether a phone is connected and in active use or whether it is disconnected and has not seen any activity.
Phone Line Type
Line type indicating if the phone is landline, mobile, fixed or non-fixed VoIP (like a Twilio or Google Voice), toll-free, etc.
Phone to Name Match
A match/no match indicator whether the name provided on the lead form matches to the input phone number according to our database. A match is a positive indicator that verifies the lead is real and is who they say they are.
Phone Contact Grade
An A-F grade determining the quality of the lead and whether it is contactable. A Grade-F lead is a bad lead and should be deprioritized, while a Grade-A lead is real and contactable and should be prioritized.
Address Is Valid
Boolean indicator if the address is valid.
Address to Name Match
A match/no match indicator whether the name provided on the lead form matches to the input address according to our database. A match is a positive indicator that verifies the lead is real and is who they say they are.
Email Is Valid
Boolean indicator if the email is valid.
Email to Name Match
A match/no match indicator whether the name provided on the lead form matches to the input email address according to our database. A match is a positive indicator that verifies the lead is real and is who they say they are.
Email Contact Grade
An A-F grade determining the quality of the lead and whether it is contactable. Grade-A is a valid email with name match, while Grade-F is an invalid or temporary email.

Smart CNAM API

Response Field
Description
ID
Trestle's persistent ID of the phone number/person returned.
Phone Number
The phone number is normalized and formatted with a country code.
Is Valid
Boolean indicator if the phone is a valid number.
Belongs To
The primary owner name of the phone. This can be a person name (parsed into first, middle, and last) or a business name.