Skip to content

// catch-all email finder

Discover Verified Emails on Catch-All Domains

Most email finders give up on catch-all domains. Tomba delivers accurate, verified addresses by analyzing 450M+ contacts and 50+ patterns so you reach real people, not dead inboxes.

// api console

GETapi.tomba.io/v1/email-finder
Example response from the API reference
email
richard@piedpiper.com
full_name
Richard Hendricks
position
CEO
company
Pied Piper
score
100
verification.status
valid
type
personal
accept_all
false
sources
1 item

// 01 · request

Catch-all Finder is one HTTPS request

Send the parameters with your key and secret. Every SDK, the CLI and the MCP server make this same call.

GET/email-finderParameter
domainpiedpiper.com
Company domain (or send company)
first_nameRichard
First name (or send full_name)
last_nameHendricks
Last name
enrich_mobilefalse
Also return phone numbers
webhook_urlhttps://example.com/webhook
Also POST the result to this URL

// 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
Libraries in the docs

// 02 · response

What comes back

JSON, the same in every language. Fields Tomba doesn't know are null, never guessed.

GET/email-finderField
data.emailstring | null
The address, or null when none is found
data.scoreinteger
Confidence from 0 to 100
data.verification.statusstring | null
valid, accept_all, invalid or unknown, with verification.date
data.full_name, data.position, data.departmentstring | null
Name, job title and team
data.typestring | null
personal or generic (a role address such as sales@)
data.linkedin, data.twitterstring | null
Public profiles
data.sources[]array | null
Up to 20 public pages where the address was found, with dates
data.accept_allboolean | null
The domain accepts mail for any address (catch-all)
data.phone_numberboolean
Tomba holds a phone number for the person
data.phone_data[]array
The numbers, when you send enrich_mobile (each as in Phone Finder)
GET /email-finder
200 OK· 1 search credit
{
  "data": {
    "email": "richard@piedpiper.com",
    "first_name": "Richard",
    "last_name": "Hendricks",
    "full_name": "Richard Hendricks",
    "website_url": "piedpiper.com",
    "company": "Pied Piper",
    "pattern": "{first}",
    "department": "executive",
    "type": "personal",
    "position": "CEO",
    "country": "US",
    "gender": "male",
    "twitter": null,
    "linkedin": "https://www.linkedin.com/in/richard-hendricks",
    "score": 100,
    "accept_all": false,
    "phone_number": true,
    "verification": {
      "date": "2025-01-15T10:32:00+01:00",
      "status": "valid"
    },
    "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": []
  }
}

// 03 · cost and limits

What a call costs

A call is charged only under the condition below. Rate limits depend on your plan.

// cost

1search credit

Charged when: An address is returned with a status other than unknown. 6 with phone data.

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
FreeBasicGrowthPro
Search, finder, similar, technology1 / 2 / 53 / 50 / 5005 / 80 / 1,0008 / 150 / 4,000
Email verifier1 / 2 / 102 / 40 / 5003 / 60 / 1,0005 / 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

// 05 · capabilities

Why Professionals Trust Tomba's Catch-All Email Finder

Proven tools that deliver results where standard email finders fail.

  • AI Pattern Recognition

    Analyzes 50+ email format patterns across the company and pinpoints the verified address even when the server accepts everything.

  • 450M+ Contact Cross-Reference

    Validates each email candidate against 450M+ contacts, web mentions, and social profiles to guarantee it belongs to a real person.

  • Instant Confidence Scoring

    Every result includes a 0-100 confidence score. Higher scores mean proven deliverability so you reach the right inbox every time.

  • Deep SMTP Verification

    Goes beyond basic MX lookups with advanced SMTP handshake techniques to detect active mailboxes hidden behind catch-all servers.

  • Pay Only for Verified Results

    No credits wasted on low-confidence results. You only pay when Tomba is confident the email is accurate and deliverable.

  • Bulk Processing at Scale

    Process thousands of catch-all domains at once via CSV upload or API. Filter results by confidence threshold and export instantly.

// faq

Catch-All Email Finder Questions

Still have questions? Visit the help center

// quick start

Make your first call in a minute

Free account, real API key, the same endpoints Enterprise customers use.

  1. 1Create a free account25 searches a month. No card.
  2. 2Copy your key and secretFrom API keys in the dashboard.
  3. 3Call the APIPaste the request; the answer is JSON.
curl "https://api.tomba.io/v1/email-finder?domain=piedpiper.com&first_name=Richard&last_name=Hendricks" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"
Response
200 OK· 1 search credit
{
  "data": {
    "email": "richard@piedpiper.com",
    "first_name": "Richard",
    "last_name": "Hendricks",
    "full_name": "Richard Hendricks",
    "website_url": "piedpiper.com",
    "company": "Pied Piper",
    "pattern": "{first}",
    "department": "executive",
    "type": "personal",
    "position": "CEO",
    "country": "US",
    "gender": "male",
    "twitter": null,
    "linkedin": "https://www.linkedin.com/in/richard-hendricks",
    "score": 100,
    "accept_all": false,
    "phone_number": true,
    "verification": {
      "date": "2025-01-15T10:32:00+01:00",
      "status": "valid"
    },
    "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": []
  }
}