// catch-all verification
Verify Emails That Other Tools Can't Check
Standard verifiers fail on catch-all domains because the server accepts everything. Tomba delivers accurate deliverability verdicts using deep SMTP analysis, pattern matching, and AI scoring trusted by 150,000+ professionals.
// api console
curl "https://api.tomba.io/v1/email-verifier?email=richard%40piedpiper.com" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY"const res = await fetch("https://api.tomba.io/v1/email-verifier?email=richard%40piedpiper.com", {
headers: {
"X-Tomba-Key": process.env.TOMBA_API_KEY,
"X-Tomba-Secret": process.env.TOMBA_SECRET_KEY
}
});
const { data } = await res.json();import os, requests
res = requests.get(
"https://api.tomba.io/v1/email-verifier?email=richard%40piedpiper.com",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
)
data = res.json()["data"]- email.email
- richard@piedpiper.com
- email.result
- deliverable
- email.status
- valid
- email.score
- 99
- email.smtp_provider
- email.accept_all
- false
- email.disposable
- false
- email.webmail
- false
- email.greylisted
- false
Based on verified reviews
// 01 · request
Catch-all Verifier is one HTTPS request
Send the parameters with your key and secret. Every SDK, the CLI and the MCP server make this same call.
/email-verifierParameteremailrequired- The address to verify
enrich_mobilefalse- Also return phone numbers
// official sdks
The same call from 13 official libraries, each one a thin wrapper over the REST API.
- C#
- Dart
- Deno
- Elixir
- Go
- Lua
- Node.js
- Perl
- PHP
- Python
- R
- Ruby
- Rust
// 02 · response
What comes back
JSON, the same in every language. Fields Tomba doesn't know are null, never guessed.
/email-verifierFielddata.email.resultstring- deliverable, risky or undeliverable; empty for a disposable domain
data.email.statusstring- valid, accept_all, invalid, unknown or disposable (compare case-insensitively: a live check can return Valid)
data.email.scoreinteger- Confidence: 99 for valid, 77 or more for accept_all, 2 for disposable
data.email.smtp_providerstring | null- Mail provider from the MX records, such as Google
data.email.mx.recordsarray | null- The domain's MX hosts
data.email.mx_check, data.email.smtp_checkboolean- The domain has MX records (smtp_check is the same check; status says whether the mailbox exists)
data.email.accept_all, data.email.greylisted, data.email.blockboolean- Catch-all domain, check deferred, check refused by the server
data.email.disposable, data.email.webmail, data.email.gibberish, data.email.regexboolean- Disposable or webmail domain, random-looking address, valid syntax
data.sources[]array- Where the address was found
data.phone_data[]array | null- Phone numbers, when you send enrich_mobile
{
"data": {
"email": {
"email": "richard@piedpiper.com",
"result": "deliverable",
"status": "valid",
"score": 99,
"smtp_provider": "Google",
"mx": {
"records": [
"aspmx.l.google.com",
"alt1.aspmx.l.google.com"
]
},
"mx_check": true,
"smtp_server": true,
"smtp_check": true,
"accept_all": false,
"greylisted": false,
"block": false,
"gibberish": false,
"disposable": false,
"webmail": false,
"regex": true,
"whois": {
"registrar_name": null,
"referral_url": null,
"created_date": null
}
},
"sources": [
{
"uri": "https://piedpiper.com/blog/engineering",
"website_url": "piedpiper.com",
"extracted_on": "2024-06-01T09:14:07+01:00",
"last_seen_on": "2025-01-10T17:02:44+01:00",
"still_on_page": true
}
],
"phone_data": null
}
}// 03 · cost and limits
What a call costs
A call is charged only under the condition below. Rate limits depend on your plan.
// cost
1verification credit
Charged when: The status is not disposable or unknown.
Errors, 429 and 451 responses, and the same request again within your usage window cost nothing.
How credits work// rate limits
Requests per second / minute / day| Free | Basic | Growth | Pro | |
|---|---|---|---|---|
| Search, finder, similar, technology | 1 / 2 / 5 | 3 / 50 / 500 | 5 / 80 / 1,000 | 8 / 150 / 4,000 |
| Email verifier | 1 / 2 / 10 | 2 / 40 / 500 | 3 / 60 / 1,000 | 5 / 100 / 4,000 |
Pro Plus, Scale and credit packs of 50,000 or more: no limit on these endpoints. Enterprise: no per-second or per-minute limit, 100,000 requests a day. Daily limits reset at 00:00 UTC. Rate limits
// 04 · use it anywhere
Catch-all Verifier beyond the API
The same endpoint, and the same credits, behind the app and every integration.
- REST APIJSON over HTTPS, 13 SDKs, signed webhooks.
GET /v1/email-finder - Bulk CSVUpload a list in the app or POST it to /bulk; download when it's done.
POST /v1/bulk/{type} - MCP for AI agentsRemote MCP server, 28 tools, OAuth sign-in.
https://mcp.tomba.io/mcp - CLIEvery endpoint from the terminal, JSON or CSV out.
tomba verify --target richard@piedpiper.com - Google Sheets and ExcelFormulas and a sidebar that call the same endpoints.
=TOMBA_VERIFY(A2) - Zapier, Make, n8nNo-code actions for the finder, verifier and enrichment.
Zapier · Make · n8n · Pipedream
// 05 · capabilities
Why Professionals Trust Tomba's Catch-All Verification
Go beyond accept-all status with proven deliverability intelligence.
Deep SMTP Handshake
Goes beyond basic MX lookups. Advanced SMTP probing detects whether a specific mailbox is actively receiving mail giving you verified results, not guesses.
AI-Powered Risk Assessment
Machine learning trained on millions of catch-all results scores each address for actual deliverability risk so you send with confidence.
Instant Confidence Score
Every result includes a 0-100 confidence score. Set your own threshold to guarantee only verified, deliverable emails reach your outreach lists.
Comprehensive Risk Flags
Identifies hidden threats disposable domains, role-based addresses, honeypots, and spam traps lurking behind catch-all configurations.
Bulk Verification at Scale
Upload a CSV of catch-all emails and verify them all at once. Our latest engine processes lists 400% faster than before.
Free Verification Credits Included
Catch-all verification credits are included free on every Tomba plan. No separate tool, no extra charges guaranteed.
// use cases
What teams build with Catch-all Verifier
- Email VerifierVerify any email address with instant, accurate results.
- Catch-All Email FinderDiscover verified emails on catch-all domains.
- Bulk VerifierVerify thousands of catch-all emails at scale via CSV.
- Email CheckerFree instant syntax and domain validation tool.
- SMTP TesterTest SMTP configuration and detect catch-all servers.
- API AccessIntegrate catch-all verification directly into your workflow.