Tomba email finder API

Business / API Key Intermediate HTTPS CORS
Varies by plan (check documentation)

Overview

Tomba is an email finding and verification service geared toward B2B sales outreach, letting you look up professional email addresses by name and company domain or verify whether an email address is deliverable. The API integrates easily into sales automation tools, CRM enrichment pipelines, or lead generation scripts. A free tier is available that includes a limited number of searches per month.

💡

Beginner Tip

Sign up at tomba.io to get your API key and secret, then test the domain search endpoint first — it returns all known professional emails for a company domain and is the easiest way to verify the API is working.

Available Data

email delivery status
message ID
bounce/complaint data
open/click tracking
stock price and symbol
open/close/high/low values

Example Response

JSON Response
{
  "message_id": "msg_abc123def456",
  "status": "delivered",
  "to": "[email protected]",
  "subject": "Welcome!",
  "timestamp": "2025-01-15T10:30:00Z"
}

Field Reference

domain The company domain that was searched
emails List of email address objects found for the domain
email The discovered email address (within each emails item)
first_name First name of the person associated with the email
last_name Last name of the person associated with the email
confidence Confidence score 0-100 indicating how reliable the email address is

Implementation Example

// ⚠️ Note: This URL may be a documentation page. Check official docs for actual API endpoint.
const url = "https://tomba.io/api";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

401 Unauthorized Missing or incorrect API key/secret pair in the request headers
Include both X-Tomba-Key and X-Tomba-Secret headers with the values from your dashboard
429 Too Many Requests Exceeding your monthly request quota on the free plan
Check your usage in the Tomba dashboard and upgrade your plan, or space out requests to stay within limits
Empty email results for a domain Tomba has no indexed emails for that domain, common for small or obscure companies
Try a larger company domain first to confirm the integration works, then handle empty results gracefully in your code

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 5/20
🔒 Security 15/15
🛠 Developer XP 17/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS YES
Category Business
Difficulty Intermediate
Verified: 2026-04-04

Similar APIs

View All →