// api enrichment

Enrich contacts in real time from your own code

13 official SDKs, REST API, MCP server for AI tools, and CLI for automation. Get your API key free and start building in minutes.

Get your API key free Read API docs

GET /enrich

curl -G https://api.tomba.io/v1/enrich \
  --data-urlencode "email=richard@piedpiper.com" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"

const params = new URLSearchParams({
  email: "richard@piedpiper.com"
});
const res = await fetch(`https://api.tomba.io/v1/enrich?${params}`, {
  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/enrich",
    params={
        "email": "richard@piedpiper.com",
    },
    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

The calls behind this workflow

Each step is one API call. The app, the browser extension and bulk jobs run the same endpoints, on the same credits.

// 02 · how it works

API key to production in minutes

Three steps to integrate Tomba into any application, CRM, or automation workflow

01
Get your API key
Sign up free, grab your API key and secret from the dashboard. No credit card, no approval process.
02
Make your first call
Install our SDK (pip install tomba, npm install tomba, etc.) and make your first enrichment call in 3 lines of code.
03
Get enriched JSON back
Receive verified emails, phones, company data, and confidence scores in a clean JSON response.

// 03 · features

Everything developers need

Build on Tomba with confidence: we handle the data infrastructure so you can focus on your product.

13 official SDKs
C#, Dart, Deno, Elixir, Go, Lua, Node.js, Perl, PHP, Python, R, Ruby and Rust. Install with one command. All 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
Connect Tomba to Claude, Cursor, Windsurf, and other AI tools via the Model Context Protocol. Your AI assistant finds emails for you.
CLI tool
Find and verify emails from your terminal. Pipe output to scripts, cron jobs, and CI/CD pipelines for automated enrichment.
Bulk & async APIs
Submit thousands of lookups as a batch job. Get notified via webhook when processing completes. No polling needed.
Full documentation
Comprehensive API reference, quickstart guides, code examples for every endpoint, and a Postman collection. Ship faster.

// 04 · tools

The tools this team uses

Person enrichment Company enrichment CSV enrichment MCP server

// 05 · 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