Skip to content

// 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.

curl -G https://api.tomba.io/v1/email-finder \
  --data-urlencode "domain=piedpiper.com" \
  --data-urlencode "first_name=Richard" \
  --data-urlencode "last_name=Hendricks" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"

// 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.

GET/email-finderA person's work email from their name and company domainCost:1 search creditCharged when:An address is returned with a status other than unknown; 6 search credits instead of 1 with phone data (enrich_mobile).
GET/domain-searchThe email addresses at a company, with names, roles and the company profileCost:1 search credit per 10 resultsCharged when:At 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 checksCost:1 verification creditCharged when:The status is not disposable or unknown. Phone numbers returned with enrich_mobile cost 5 search credits each, from the search allowance.
GET/enrichThe person behind an email address: name, role, company and profilesCost:1 search creditCharged when:An address is returned with a status other than unknown; 6 search credits instead of 1 with phone data (enrich_mobile).
GET/linkedinThe work email of the person behind a LinkedIn profile URLCost:1 search creditCharged when:An address is returned; 6 search credits instead of 1 with phone data (enrich_mobile).
GET/author-finderThe email of the person who wrote an articleCost:1 search creditCharged when:An address is returned.
GET/phone-finderA person's phone number from their email, domain or LinkedIn URLCost:5 search creditsCharged when:A valid number is returned; 1 search credit instead of 5 when you search by domain.
GET/phone-validatorWhether a phone number is valid, its line type, carrier and regionCost:1 search creditCharged when:Every successful response, including one with no data.
POST/reveal/searchCompanies that match a plain-language query or filtersCost:1 search creditCharged when:At least one company is returned.
GET/combined/findThe person and their company from one email addressCost:2 search creditsCharged when:A person is returned.
GET/companies/findA company profile from its domain: industry codes, size, location, socialsCost:1 search creditCharged when:A company is returned.
GET/technologyThe technologies a website runs, by categoryCost:FreeCharged when:Not charged; needs a positive search balance.
GET/email-countHow many addresses Tomba holds for a domain, by department and seniorityCost:1 email count creditCharged when:Every call.
GET/similarCompanies similar to a domain, with their industryCost:1 search credit per 10 resultsCharged when:Results are returned. 1 credit per 10 results requested with limit.
GET/email-formatThe address patterns a company uses, with their shareCost:1 email count creditCharged when:Every successful call, including an empty result.
GET/locationWhere a company's people are, by countryCost:1 email count creditCharged when:Every successful call, including an empty result.
GET/people/findA person profile from a work email: name, employment, location, social handlesCost:1 search creditCharged when:A 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.

// 04 · customers

What customers say

  • I've tested over a dozen email finder tools, and Tomba.io stands out as the best. It consistently delivers accurate results and is incredibly easy to set up using the API key.
    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'd rate it 9/10.
    Benjie MalinaoCo-Founder & CTO, Channel Automation
  • Tomba.io is very fast and has lots of features to help anyone prospect and find exactly who you need to find. I use my zoom.info and Apollo to find companies for lead gen and then run those leads into tomba to grab me prospect info in record time.
    Julian M.Account Executive, Insightvia G2
  • As a Founder, as well as a sales leader, there are three things that are important to me when I choose an email finder solution. It's got to be cost effective, easy to use and of course the data has to be accurate, I actively recommend it.
    Kevin DixonFounder, Boxxstep

// 05 · faq

Developer FAQ

Still have questions? Visit the help center

// start free

See who Tomba finds at any company

Type a company's domain to see its people, their roles and verified work emails, each with the pages it was found on. Free account, no card.