Tomba email finder API

Business / API Key Intermediate HTTPS CORS

77 B

Metadata Score Metadata estimate · not endpoint-tested

Visit Official Site Compare Alternatives

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

The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.

email delivery status

message ID

bounce/complaint data

open/click tracking

stock price and symbol

open/close/high/low values

Example Response

Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded response.

JSON Response · Illustrative

{
  "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

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request

const url = "https://api.tomba.io/v1/domain-search?domain=stripe.com";
// 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

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

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

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

How is this scored? →