Trestle - Identity Data Enrichment and Validation APIs Trestle - Identity Data Enrichment and Validation APIs Trestle - Identity Data Enrichment and Validation APIs Trestle - Identity Data Enrichment and Validation APIs
  • Products
        • Enrichment

        • Reverse Phone APIGLOBAL
        • Verify and enrich phone numbers
        • Reverse Address API
        • Verify and enrich address information
        • Caller Identification API
        • Identify and enrich caller information
        • Add-Ons

        • Litigator Check
        • Identify phone numbers associated with serial litigators
        • Email Deliverability
        • Confirm email inboxes accept mail in real-time
        • Spam Check
        • Flag phone numbers tied to high-risk calling activity
        • Email Age Score
        • Score how long an email has existed
        • Validation & Verification

        • Phone Validation APIGLOBAL
        • Validate phone numbers and identify disconnected numbers
        • Real Contact API
        • Verify phone, email, and address information
        • Address Validation API
        • Validate and normalize addresses
        • Assess Risk

        • Decision Console
        • Optimize identity verification for manual review
        • Decision Signals API
        • Automate identity verification for risk decisioning
        • Start using Trestle products today

          Get started for free—no credit card required

          Start Your Free Trial

  • Solutions
        • Industries

        • B2B Contact Data
        • eCommerce
        • Insurance
        • Lead Generation
        • Real Estate
        • Communications
        • Use Cases

        • Verify and Prioritize Leads
        • Outbound Dialing Optimization
        • Assess Risk And Prevent Fraud
        • Inbound Call Routing and Verification​
        • Signup and Onboarding​
        • Optimize AI Voice Agents
        • Start using Trestle products today

          Get started for free—no credit card required

          Start Your Free Trial

  • Pricing
  • Resources
        • API Documentation
        • Blog
        • Knowledge Base
        • Case Studies
        • Glossary
        • Partners and Integrations
  • Company
        • About Us
        • Why Trestle
        • Careers
        • Affiliate Program
        • Contact
  • Log In
  • Start for Free

Trestle Overview

19
  • Does Trestle Offer DNC Checks?
  • Does Trestle Have a Sandbox Environment To Test Integrations?
  • What is Trestle’s Coverage and Accuracy?
  • Which Countries’ Data Do You Have?
  • Does Trestle Normalize Phone Number Format?
  • How Do You Integrate Trestle’s APIs?
  • How Does Trestle’s API Pricing Work?
  • How Often is Trestle’s Data Updated?
  • How to Properly Sample a Test File and Evaluate Trestle
  • Understanding NPA-NXX and the Implications of Number Portability
  • Understanding Trestle’s Free API Trial and the API Access Request Process for Specific Products
  • What are the Response Times for Trestle’s APIs?
  • What are the Various Sources of Trestle’s Identity Data?
  • What are Trestle’s SLAs?
  • What Demographic Data Does Trestle Have?
  • What Is Our Global Phone Validation Coverage?
  • What is the Default and Max QPS Supported?
  • What Queries are Billable?
  • What Security Measures are Taken by Trestle?

Product Features

38
  • Everything to Know About IP Trust Scores
  • How to Check When an Email Address Was Made
  • Everything to Know About Spam Checks
  • Using IP Intelligence Checks to Verify Lead Legitimacy in Real Contact API
  • Everything to Know About Phone-to-Address Match
  • Real Contact API 1.1 vs. Real Contact API 2.0: What’s Changed and How to Upgrade
  • Everything to Know About Phone Activity Score
  • Everything to Know About Real Contact API 2.0
  • How Trestle’s Activity Score is Different From HLR Lookups
  • Everything To Know About Name Match Details
  • Everything To Know About Phone-to-Name Confidence Score
  • Everything To Know About Litigator Checks
  • Everything To Know About the Email Age Score Add-on
  • Everything To Know About the Email Deliverability Add-on
  • Explain Real Contact API Grading
  • Fine-Tuning Find Person API Results
  • How Can Trestle’s Email Data Be Used?
  • How Do I Determine Phone Validity?
  • How Do You Read Trestle’s Phone Activity Score?
  • How Does Our Real Contact API Name Matching Work?
  • How Does Trestle Assess Email Validity in Real Contact?
  • How is Trestle’s Phone Activity Score Calculated?
  • How To Read the Real Contact Data Assessment Report
  • International Reverse Phone API Explained
  • Line Type Fidelity and Confidence
  • Trestle API Response Attribute Ranking
  • Trestle Warnings – A Comprehensive Guide
  • Understanding the Difference: Phone Validity vs. Trestle’s Activity Score
  • What are the Different Address Types Returned by Trestle?
  • What Does a Name Match of Null Mean?
  • What Does the Carrier Name Mean?
  • What is the Difference Between CNAM and Trestle’s Smart CNAM API?
  • What is the Difference Between Fixed VoIP and Non-fixed VoIP?
  • What is the Difference Between Reverse Phone API, Caller Identification API, and Smart CNAM API?
  • What is the Link Date Associated with Phones and Addresses?
  • Why and When to Use Trestle’s Name Hint
  • Why Do We Return a Maximum of 100 Entities in Find Person API?
  • Why Does the Address Return as Invalid?

Integrations

22
  • HubSpot | Phone Validation App Integration Guide
  • ZoomInfo | Phone Validation, Real Contact, and Reverse Phone Integration Guide
  • Databar | Phone Validation Integration Guide
  • Make | Real Contact API Integration Guide
  • Make | Phone Validation API Integration Guide
  • Apollo | Phone Validation Integration Guide
  • HighLevel | Phone Validation Integration Guide
  • boberdoo | Real Contact API Integration Guide
  • Clay | Validate Phone Number Integration Guide
  • Clay | Verify Contact Integration Guide
  • HubSpot | Real Contact Phone Grading App Integration Guide
  • How Do I Use a HubSpot List To Grade My Contacts?
  • How Do I Use HubSpot Workflow Triggers To Grade My Contacts?
  • Lead Prosper | Phone Validation Integration Guide
  • Lead Prosper | Real Contact Integration Guide
  • Reverse Phone API Enrichment of Leads in Google Sheets via Zapier
  • Snowflake | Phone Validation Integration Guide
  • What is the Phone Validation Integration within ActiveProspect?
  • What is the Real Contact Integration within ActiveProspect?
  • Validate and Verify Leads with Trestle’s Phone Validation API in Sierra Interactive via Zapier
  • Validate Leads with Trestle’s Phone Validation API in LeadConnector via Zapier
  • Zapier | Grade Leads from a Google Sheet with Real Contact

Troubleshooting

9
  • How to Prevent 429 Errors by Sizing API Concurrency to Your QPS Limit
  • How to Fix 403 Forbidden Errors When Using Trestle’s APIs
  • Why Won’t My Email Work to Signup for Trestle?
  • Ruby Integrations: 403 Forbidden Errors
  • Getting 429: Too Many Requests Error – Why?
  • How to Remove or Deactivate a User in Trestle’s Developer Portal
  • How to Update Phone to Name/Address Linkage Records
  • Reviewing Usage Data
  • Why is the Name Associated with the Phone Incorrect?

Developer Portal

8
  • Business Verification Failed? Here’s What Documents You Need to Submit
  • How to Find and Download Your Receipt or Invoice
  • How to Monitor API Errors With Your Usage Graph
  • Batch Upload FAQ
  • Developer Portal Wallet Frequently Asked Questions
  • Export and Analyze Your Queries in Your Developer Portal Account
  • Getting Started with Trestle’s Developer Portal Wallet
  • Making Changes to Billing Settings for the Developer Portal Wallet

User Guides

9
  • Phone Validation in Java
  • Batch Upload Instructions
  • How Do I add Additional Members to My Trestle Account?
  • How to Handle Special Characters in API Queries
  • Phone Validation API with ASP.NET
  • Phone Validation with JavaScript and HTML: Leveraging Trestle’s API
  • Phone Validation API with PHP: Leveraging Trestle’s API
  • Phone Validation API with Python
  • Phone Validation API with React

Telephony Knowledge

9
  • Choosing the Right Number Lookup API
  • How to Identify Callers In Real-Time Using a Reverse Phone API
  • Why is Line Type Intelligence Important?
  • What is a “No Routes Found” Phone Message?
  • The Best Phone Validation API for Call Centers
  • How to Identify Disconnected Phone Numbers Automatically
  • What is a Phone Number Reputation Lookup?
  • What is a Carrier Number?
  • What is a Non-Fixed VoIP Phone?

Risk Suite Overview

8
  • How to Read Email Breach Reports and IP Abuse Reports in Decision Console
  • Everything to Know About Decision Signals API
  • How to Get Started With Decision Console
  • What is the Decision Overview and How Do I Read It?
  • What is an Attribute Card and How Do I Read It?
  • What is Link Builder and How Do I Use It?
  • Understanding Team and Account Management
  • FAQ and Troubleshooting: Decision Console
  • Home
  • Knowledge Base
  • Product Features
  • Explain Real Contact API Grading
View Categories

Explain Real Contact API Grading

4 min read

Real Contact API is designed to validate and verify multiple lead inputs. It assesses the contactability of a lead and flags the leads least likely to be reached. Real Contact API’s response includes:

  • Phone Activity Score, which indicates if a phone is connected or disconnected
  • Name Match, which indicates whether the name provided by the lead matches the owner of the input phone number or email according to Trestle’s database
  • Line Type, which provides seven unique line types, including mobile, fixed and non-fixed VoIP, landline, premium, toll-free, and voicemail service
  • Contact Grade for phone and email, which is a grade determining the quality of the lead and whether it is contactable
  • IP-based intelligence, including a trust score (0-100) that evaluates the legitimacy of the user, and IP-to-address distance, which measures the geographic distance between the IP location and the provided physical address

This allows you to prioritize leads with the best chance of contactability and flag leads that may not be authentic. For phones, this grade is based on whether the number is connected or disconnected, reachable or a temporary number, and belongs to the person they say they are. It also allows you to reach your target audience by managing your business’ phone reputation by avoiding outgoing calls to disconnected or temporary numbers. For emails, the contact grade is based on email validity and domain reputation and belongs to the person they say they are.

Trestle provides five grades: A, B, C, D, and F. These grades determine the quality of the lead and whether it is contactable. A Grade F lead is considered a bad lead and should be deprioritized, while a Grade A lead is considered real and contactable and should be prioritized.

Phone Contact Grade #

GradeMeaning
AThe phone provided is valid, has high levels of activity, and is a mobile phone with a high-confidence name match to the lead.
BThe phone is valid and has consistent activity levels; however, it is either a landline with a name match, or a mobile phone with a lower-confidence name match. This can still be a good lead, but it might be that the phone is part of a family plan, which is why Trestle has a different subscriber name associated with it or that Trestle doesn’t have any name associated with that phone. Depending on the team’s bandwidth, these leads can be accepted but should be prioritized below Grade A leads.
CThe phone has lower activity or weaker identity alignment. These leads are best suited for automated nurture sequences or should be pursued after higher-grade leads are exhausted.
DThe phone is valid, but the phone’s activity has been inconsistent, and the name doesn’t match the subscriber data in Trestle’s database. Typically, these leads should be deprioritized.
FThe phone is invalid, likely disconnected, a non-fixed VoIP (Google Voice or Twilio number) not associated with anyone in Trestle’s database, or a toll-free/premium number. These leads should be deprioritized. If the Litigator Check Add-on is enabled and phone_is_litigator_risk = TRUE, the phone will automatically receive a Grade-F, as it is likely associated with a known TCPA or serial litigator.

Email Contact Grade #

Please note: Selecting the Email Deliverability and/or Email Age Score Add-ons provides more nuanced contact grading for better lead prioritization.

GradeMeaning
AThe email has valid syntax (How Does Trestle Assess Email Validity in Real Contact?), deliverable (Deliverability Add-on enabled), seen in our network with consistent activity (Age Score Add-on enabled) and it belongs to the name provided, meaning the lead is who they say they are.
BThe email has a valid syntax, is deliverable (Email Deliverability Add-on enabled), and has consistent activity in our network (Age Score Add-on enabled). However, the name doesn’t match the name associated with this email in Trestle’s database. Or, Trestle doesn’t have coverage for this email, so we cannot do the matching. Depending on the team’s bandwidth, these leads can be accepted but should be prioritized below Grade A leads.
CThe email has valid syntax; however, the email user names are tumbled or role-based accounts, or the email is newly seen in our network (Email Age Score Add-on enabled). Generally, these leads are difficult to reach and should be prioritized relatively low.
DThe email has valid syntax, but the username might contain specific words like ‘test’ or abuse words, or the email is newly seen in our network (Email Age Score Add-on enabled). Generally, these leads are difficult to reach and should be prioritized relatively low.
FThe email is invalid, undeliverable (Email Deliverability Add-on enabled), is newly seen in our network (Email Age Score Add-on enabled), the domain is disposable, or it’s flagged as a junk email. If leads are filtered by email, these leads should be deprioritized.

Recommendations #

Depending on the business problem, here are some recommendations on the right filter to apply:

Lead Type Problem(s)SuggestionROI
First Party (Form Fills)You want the sales team to focus on only viable leads.Filter out Grade D and F leadsHigher conversion rates and saves the sales rep time.
Third Party (List Purchase) You have too many leads to call and not enough bandwidth.

You’re tired of buying leads that never convert.
Call Grade A leads and do not purchase Grade D or F leadsHigher conversion rates, ability to process more leads, and better conversions.

Saves costs by not purchasing junk leads and improves overall ROI.
First Party Leads (Historic)You want to know which leads of the historic list have the best chance of converting.Call Grade A leads Higher conversion rates, saving sales rep time.
Any Your contact rates are too low and numbers are getting marked as spam by carriers.Filter out Grade D or F leads and prioritize Grade A leads Higher contact and conversion rates and reduced risk of spam blocking.

Benchmarks #

Additionally, see below for the typical benchmarks from working with a range of customers. Of course, this data is across multiple industries, but these benchmarks can help decide the category and which filters to apply.

Lead Type Grade AGrade F
First Party (Form Fills)50-70%5-20%
Third Party (List Purchase) 20-50%10-30%
First Party Leads (Historic)40-60%10-30%
Start Your Free Trial
Updated on April 22, 2026
Everything To Know About the Email Deliverability Add-onFine-Tuning Find Person API Results
Table of Contents
  • Phone Contact Grade
  • Email Contact Grade
  • Recommendations
  • Benchmarks
trestleLogo

Verified Identities. Trusted Interactions.

U.S. coverage for enrichment and verification.

Global coverage for phone validation and reverse phone.

Based in Bellevue, WA

Linkedin Github Postman

Company

  • About Us
  • Why Trestle
  • Careers
  • Affiliate Program
  • Contact

Products

  • Reverse Phone API
  • Reverse Address API
  • Caller Identification API
  • Phone Validation API
  • Real Contact API
  • Address Validation API
  • Batch Upload
  • Litigator Check Add-on
  • Free Lead Assessment

Use Cases

  • Outbound Dialing Optimization
  • Inbound Call Routing and Verification
  • Signup and Onboarding
  • Lead Verification
  • Optimize AI Voice Agents

Resources

  • Blog
  • Knowledge Base
  • Case Studies
  • Glossary
  • Data Dictionary
  • Changelog
  • Partners and Integrations

Developers

  • Developer Portal
  • API Documentation
  • API Live Status

Legal

  • Terms of Service
  • Privacy Policy
  • Data Processing Agreement
  • Service Level Agreement
  • Do Not Sell My Personal Information
Trestle - Identity Data Enrichment and Validation APIs
  • Products
        • Enrichment

        • Reverse Phone APIGLOBAL
        • Verify and enrich phone numbers
        • Reverse Address API
        • Verify and enrich address information
        • Caller Identification API
        • Identify and enrich caller information
        • Add-Ons

        • Litigator Check
        • Identify phone numbers associated with serial litigators
        • Email Deliverability
        • Confirm email inboxes accept mail in real-time
        • Spam Check
        • Flag phone numbers tied to high-risk calling activity
        • Email Age Score
        • Score how long an email has existed
        • Validation & Verification

        • Phone Validation APIGLOBAL
        • Validate phone numbers and identify disconnected numbers
        • Real Contact API
        • Verify phone, email, and address information
        • Address Validation API
        • Validate and normalize addresses
        • Assess Risk

        • Decision Console
        • Optimize identity verification for manual review
        • Decision Signals API
        • Automate identity verification for risk decisioning
        • Start using Trestle products today

          Get started for free—no credit card required

          Start Your Free Trial

  • Solutions
        • Industries

        • B2B Contact Data
        • eCommerce
        • Insurance
        • Lead Generation
        • Real Estate
        • Communications
        • Use Cases

        • Verify and Prioritize Leads
        • Outbound Dialing Optimization
        • Assess Risk And Prevent Fraud
        • Inbound Call Routing and Verification​
        • Signup and Onboarding​
        • Optimize AI Voice Agents
        • Start using Trestle products today

          Get started for free—no credit card required

          Start Your Free Trial

  • Pricing
  • Resources
        • API Documentation
        • Blog
        • Knowledge Base
        • Case Studies
        • Glossary
        • Partners and Integrations
  • Company
        • About Us
        • Why Trestle
        • Careers
        • Affiliate Program
        • Contact
  • Log In
  • Start for Free