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.

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.
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.
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 Address
Current address of the subscriber, including full address, postal code, coordinates, and the date of when the subscriber was associated with the address.

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 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.
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.
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.
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.
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.
IP Trust Score
The IP Trust Score is a 0–100 score that evaluates how legitimate an identity appears based on the user’s IP address. It factors in network type (VPN, proxy, data center vs. residential), IP reuse/sharing patterns, and geographic signals to determine whether the identity is genuine or potentially risky.
IP Distance to Address
The approximate distance (in miles) between the user’s IP location and the provided address.

Decision Signals API

Response Field
Description
Identity Score
A 0-100 value that provides an aggregated assessment of the identity, where a higher score means high trust and low risk.
Primary Phone Is Valid
Boolean indicator if the primary phone is a valid number and assigned to a carrier.
Primary Phone Country Code
The ISO-3166 alpha-2 country code of the primary phone number.
Primary Phone Is Commercial
Boolean indicator if the primary phone number is registered to a business.
Primary Phone Line Type
Line type indicating if the primary phone is landline, mobile, fixed or non-fixed VoIP (like a Twilio or Google Voice), toll-free, etc.
Primary Phone Carrier
The MVNO level carrier that provides the service to the subscriber.
Primary Phone Is Prepaid
Boolean indicator if the primary phone number is associated with a prepaid account.
Primary Phone-to-Name Match
A match/no match indicator whether the name provided matches to the primary 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.
Primary Phone-to-Address Match
An indicator that compares the primary phone subscriber’s location to the address you provide. Returns Full Match, Street Match, Postal Match, City State Match, Metro Match, No Match, or null depending on the level of match granularity.
Secondary Phone Is Valid
Boolean indicator if the secondary phone number is a valid number and assigned to a carrier.
Secondary Phone Country Code
The ISO-3166 alpha-2 country code of the secondary phone number.
Secondary Phone Is Commercial
Boolean indicator if the secondary phone number is registered to a business.
Secondary Phone Line Type
Line type indicating if the secondary phone is landline, mobile, fixed or non-fixed VoIP (like a Twilio or Google Voice), toll-free, etc.
Secondary Phone Carrier
The MVNO level carrier that provides the service to the subscriber.
Secondary Phone Is Prepaid
Boolean indicator if the secondary phone number is associated with a prepaid account.
Secondary Phone-to-Name Match
A match/no match indicator whether the name provided matches to the secondary 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.
Secondary Phone-to-Address Match
An indicator that compares the secondary phone subscriber’s location to the address you provide. Returns Full Match, Street Match, Postal Match, City State Match, Metro Match, No Match, or null depending on the level of match granularity.
Primary Address Is Valid
Boolean indicator if the primary address is valid and exists in the real world.
Primary Address Is Commercial
Boolean indicator if the primary address is associated with a business.
Primary Address Is Freight Forwarder
Boolean indicator if the primary address is a known freight forwarding address. True values typically indicate high risk.
Primary Address Type
Indicates the primary address type. Can be Single Unit, Multi-Unit, PO Box, Firm, General Delivery, Rural Route, or null if the address is invalid.
Primary Address-to-Name Match
A match/no match indicator whether the name provided on the lead form matches to the primary input address according to our database. A match is a positive indicator that verifies the person is real and is who they say they are.
Secondary Address Is Valid
Boolean indicator if the secondary address is valid and exists in the real world.
Secondary Address Is Commercial
Boolean indicator if the secondary address is associated with a business.
Secondary Address Is Freight Forwarder
Boolean indicator if the secondary address is a known freight forwarding address. True values typically indicate high risk.
Secondary Address Type
Indicates the secondary address type. Can be Single Unit, Multi-Unit, PO Box, Firm, General Delivery, Rural Route, or null if the address is invalid.
Secondary Address-to-Name Match
A match/no match indicator whether the name provided on the lead form matches to the secondary input address according to our database. A match is a positive indicator that verifies the person is real and is who they say they are.
Distance From Primary Address
The approximate distance (in miles) between the primary and secondary addresses.
Primary Email Is Valid
Boolean indicator if the primary email is valid.
Primary Email Is Disposable
Boolean indicator if the primary email domain is a known disposable or temporary provider.
Primary Email Age Score
A 0-100 score that indicates the longevity and activity level of the primary email address, where 0 is a recent email.
Primary Email Domain Creation Days
How many days since the primary email’s domain was first registered.
Primary Email-to-Name Match
A match/no match indicator whether the name provided matches to the primary input email address according to our database. A match is a positive indicator that verifies the person is real and is who they say they are.
Secondary Email Is Valid
Boolean indicator if the secondary email is valid.
Secondary Email Is Disposable
Boolean indicator if the secondary email domain is a known disposable or temporary provider.
Secondary Email Age Score
A 0-100 score that indicates the longevity and activity level of the primary email address, where 0 is a recent email.
Secondary Email Domain Creation Days
How many days since the secondary email’s domain was first registered.
Secondary Email-to-Name Match
A match/no match indicator whether the name provided matches to the secondary input email address according to our database. A match is a positive indicator that verifies the person is real and is who they say they are.
IP Is Valid
Boolean indicator if the IP address is a valid, publicly routable address. Returns false if it is a private or loopback IP address.
IP Trust Score
A 0–100 score that evaluates how legitimate the identity appears based on the user’s IP address. It factors in network type (VPN, proxy, data center vs. residential), IP reuse/sharing patterns, and geographic signals to determine whether the identity is genuine or potentially risky.
IP Connection Type
Returns the IP connection type, including Residential, Mobile, Hosting, VPN, Business VPN, Government VPN, Education VPN, Hosting VPN, Proxy, Tor, Anycast, Privacy Relay, or Satellite.
IP Geolocation
The geographic location of the IP address. Includes Postal Code, City Name, Subdivision, Country Name, Country Code, and Continent Code.
IP Distance From Primary Address
The approximate distance (in miles) between the IP geolocation and the primary address.
IP Distance From Secondary Address
The approximate distance (in miles) between the IP geolocation and the secondary address.
IP Distance From Primary Phone
The approximate distance (in miles) between the IP geolocation and the address of the person associated with the primary phone.
IP Distance From Secondary Phone
The approximate distance (in miles) between the IP geolocation and the address of the person associated with the secondary phone.

Add-ons Available:

Add-on
Description
Product Available
Litigator Checks
Identifies if the phone subscriber is associated with a serial litigation under TCPA or similar regulation.
Real Contact API and Phone Validation API
Email Deliverability Checks
Identifies if the email is deliverable.
Real Contact API
Email Age Score
A 0-100 score that indicates the longevity and activity level of the email address, where 0 is a recent email.
Real Contact API
Spam Checks
Identifies if the phone number is tied to unwanted or high-risk calling activity.
Caller Identification API