// for developers

Build Email Intelligence into Anything You Ship

13 SDKs. REST API. MCP server. CLI. Full docs. Install with one command and start enriching contacts from your code in 3 minutes.

Get Your API Key Free Read API Docs

GET /email-finder

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"

const res = await fetch("https://api.tomba.io/v1/email-finder?domain=piedpiper.com&first_name=Richard&last_name=Hendricks", {
  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-finder?domain=piedpiper.com&first_name=Richard&last_name=Hendricks",
    headers={
        "X-Tomba-Key": os.environ["TOMBA_API_KEY"],
        "X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
    },
)
data = res.json()["data"]

// teams at these companies use tomba

// 01 · workflow

Every endpoint, its cost and its reference

REST over HTTPS, two headers for authentication, JSON back. The SDKs, the CLI and the MCP server make the same calls.

EndpointReturnsCostCharged when

GET/email-finderA person's work email from their name and company domain1 search creditAn address is returned with a status other than unknown. 6 with phone data.

GET/domain-searchThe email addresses at a company, with names, roles and the company profile1 per 10 search creditsAt least one address is returned. 1 credit per 10 results requested with limit.

GET/email-verifierWhether an address is deliverable: syntax, MX, SMTP, catch-all and greylisting checks1 verification creditThe status is not disposable or unknown.

GET/enrichThe person behind an email address: name, role, company and profiles1 search creditAn address is returned with a status other than unknown. 6 with phone data.

GET/linkedinThe work email of the person behind a LinkedIn profile URL1 search creditAn address is returned. 6 with phone data.

GET/author-finderThe email of the person who wrote an article1 search creditAn address is returned.

GET/phone-finderA person's phone number from their email, domain or LinkedIn URL5 search creditsA valid number is returned. 1 when the request includes domain.

GET/phone-validatorWhether a phone number is valid, its line type, carrier and region1 search creditEvery successful response, including one with no data.

POST/reveal/searchCompanies that match a plain-language query or filters1 search creditPer request, when at least one company is returned.

GET/combined/findThe person and their company from one email address2 search creditsA person is returned.

GET/companies/findA company profile from its domain: industry codes, size, location, socials1 search creditA company is returned.

GET/technologyThe technologies a website runs, by categoryFreeNot charged; needs a positive search balance.

GET/email-countHow many addresses Tomba holds for a domain, by department and seniority1 email count creditEvery call.

GET/similarCompanies similar to a domain, with their industry1 per 10 search creditsResults are returned. 1 credit per 10 results requested with limit.

GET/email-formatThe address patterns a company uses, with their share1 email count creditEvery successful call, including an empty result.

GET/locationWhere a company's people are, by country1 email count creditEvery successful call, including an empty result.

GET/people/findA person profile from a work email: name, employment, location, social handles1 search creditA person is returned.

Base URL https://api.tomba.io/v1 · Send X-Tomba-Key and X-Tomba-Secret with every request.Every endpoint in the API reference

// 02 · features

The Developer Experience You Deserve

We obsess over DX so you can obsess over your product. Install, authenticate, and ship all in under 5 minutes.

13 Official SDKs
C#, Dart, Deno, Elixir, Go, Lua, Node.js, Perl, PHP, Python, R, Ruby and Rust. One-command install. All maintained and open-source on GitHub.
Limits You Can Plan For
Rate limits are published per plan and endpoint, and GET /v1/rate-limits returns the ones that apply to your account.
MCP Server for AI
Connect Tomba to Claude, Cursor, Windsurf, and any MCP-compatible AI tool. Your AI assistant finds and verifies emails natively.
CLI for Automation
tomba find, tomba verify, tomba search pipe results to scripts, cron jobs, CI/CD pipelines. Perfect for automation workflows.
Bulk & Async APIs
Submit batch jobs with thousands of records. Get webhook notifications when done. No polling, no timeouts.
Docs That Don't Suck
API reference, quickstart guides, code examples for every language, Postman collection, and OpenAPI spec. Copy-paste and go.
Simple Auth
API key + secret header. No OAuth dance. No token refresh. Just two headers and you're making calls.
15+ Endpoints
Email finder, verifier, domain search, enrichment, phone finder, author finder, LinkedIn finder, similar domains, technology, and more.
Works With Your Stack
REST means it works with anything. Plus Zapier, Make, n8n, and direct CRM integrations for no-code workflows.

// 03 · tools

The tools this team uses

API Documentation MCP Server CLI API Enrichment

I have tested over a dozen email finder tools, and Tomba.io stands out as the best. It provides a solid SDK and clear, well-documented guides, making integration fast and straightforward.
Andrei KholkinFounder, Superpage.io
The data is always fresh, and the n8n integration is excellent for my use case. Support is very responsive overall. I would rate it 9/10.
Benjie MalinaoCo-Founder & CTO, Channel Automation
Tomba.io is very fast and has lots of features. I use Apollo to find companies and then run those leads into Tomba.io to grab prospect info in record time.
Julian M.Account Executive, Insight
As a Founder and sales leader, there are three things important to me: cost effective, easy to use, and accurate data. I actively recommend Tomba.io.
Kevin DixonFounder, Boxxstep