Skip to content
Tomba home
Start free

// free email enrichment

Turn Emails into Complete Profiles

Stop working with incomplete lead data. Enrich email addresses instantly with verified names, job titles, company details, direct phone numbers, and social profiles so every outreach is informed and targeted.

Get free API keyAPI reference
GETapi.tomba.io/v1/enrich
Example response from the API reference
email
richard@piedpiper.com
full_name
Richard Hendricks
position
CEO
company
Pied Piper
score
100
verification.status
valid
type
personal
accept_all
false
sources
1 item
CapterraCapterra
4.7/5
G2G2
4.7/5
Chrome Web StoreChrome Web Store
4.6/5

Based on verified reviews

// 01 · request

Enrichment is one HTTPS request

Send the parameters with your key and secret. Every SDK, the CLI and the MCP server make this same call.

GET/enrichParameter
emailrequired
The address to enrich
enrich_mobilefalse
Also return phone numbers

// official sdks

The same call from 13 official libraries, each one a thin wrapper over the REST API.

  • C#
  • Dart
  • Deno
  • Elixir
  • Go
  • Lua
  • Node.js
  • Perl
  • PHP
  • Python
  • R
  • Ruby
  • Rust
Libraries in the docs

// 02 · response

What comes back

JSON, the same in every language. Fields Tomba doesn't know are null, never guessed.

GET/enrichField
data.emailstring | null
The address, or null when none is found
data.scoreinteger
Confidence from 0 to 100
data.verification.statusstring | null
valid, accept_all, invalid or unknown, with verification.date
data.full_name, data.position, data.departmentstring | null
Name, job title and team
data.typestring | null
personal or generic (a role address such as sales@)
data.linkedin, data.twitterstring | null
Public profiles
data.sources[]array | null
Up to 20 public pages where the address was found, with dates
data.company, data.website_urlstring | null
The company and its domain
data.disposable, data.webmailboolean
The address is on a disposable or webmail domain
data.accept_allboolean | null
The domain accepts mail for any address (catch-all)
data.phone_numberboolean
Tomba holds a phone number for the person
data.phone_data[]array
The numbers, when you send enrich_mobile (each as in Phone Finder)
GET /enrich
200 OK· 1 search credit
{
  "data": {
    "email": "richard@piedpiper.com",
    "first_name": "Richard",
    "last_name": "Hendricks",
    "full_name": "Richard Hendricks",
    "website_url": "piedpiper.com",
    "company": "Pied Piper",
    "pattern": "{first}",
    "department": "executive",
    "type": "personal",
    "position": "CEO",
    "country": "US",
    "gender": "male",
    "twitter": null,
    "linkedin": "https://www.linkedin.com/in/richard-hendricks",
    "score": 100,
    "accept_all": false,
    "phone_number": true,
    "verification": {
      "date": "2025-01-15T10:32:00+01:00",
      "status": "valid"
    },
    "sources": [
      {
        "uri": "https://piedpiper.com/blog/engineering",
        "website_url": "piedpiper.com",
        "extracted_on": "2024-06-01T09:14:07+01:00",
        "last_seen_on": "2025-01-10T17:02:44+01:00",
        "still_on_page": true
      }
    ],
    "disposable": false,
    "webmail": false,
    "phone_data": []
  }
}

// 03 · cost and limits

What a call costs

A call is charged only under the condition below. Rate limits depend on your plan.

// cost

1search credit

Charged when: An address is returned with a status other than unknown. 6 with phone data.

Errors, 429 and 451 responses, and the same request again within your usage window cost nothing.

How credits work

// rate limits

Requests per second / minute / day
FreeBasicGrowthPro
Search, finder, similar, technology1 / 2 / 53 / 50 / 5005 / 80 / 1,0008 / 150 / 4,000
Email verifier1 / 2 / 102 / 40 / 5003 / 60 / 1,0005 / 100 / 4,000

Pro Plus, Scale and credit packs of 50,000 or more: no limit on these endpoints. Enterprise: no per-second or per-minute limit, 100,000 requests a day. Daily limits reset at 00:00 UTC. Rate limits

// 04 · use it anywhere

Enrichment beyond the API

The same endpoint, and the same credits, behind the app and every integration.

// 05 · capabilities

Email Enrichment Features

Turn any email address into a complete, verified contact and company profile everything you need to close the deal.

  • Full Company Enrichment

    Get company name, industry, headcount, revenue, location, social profiles, and technologies all included free with every lookup. No hidden charges.

  • Job Title & Department

    Know exactly who you're reaching out to get current job title, department, seniority level, and role for laser-targeted outreach.

  • Direct Phone Numbers

    Find verified mobile and business phone numbers alongside the email. Call, WhatsApp, or SMS your contacts without extra lookups.

  • Social Profiles

    Get LinkedIn, Twitter/X, Facebook, and GitHub profiles automatically linked so you can connect on every channel.

  • Profile Photos

    Retrieve the contact's profile picture from LinkedIn, Gravatar, and other public sources put a face to every name in your CRM.

  • Source URLs & Dates

    See every public source where the email was found with URLs, discovery dates, and active/inactive status for full transparency.

  • Real-time Verification

    Every email is verified for deliverability in real time. Get confidence scores and catch-all detection before you hit send.

  • Country & Location

    Know where your contact is based country, city, and timezone detected automatically, so you time your outreach perfectly.

  • Technology Stack

    See what technologies the company uses CMS, analytics, marketing tools, hosting ideal for tech-targeted sales conversations.

  • Bulk Enrichment

    Upload a CSV with thousands of email addresses for batch enrichment. Export all contact and company data at once no manual work.

  • REST API & SDKs

    Integrate enrichment into your pipeline with our REST API and 13 official SDKs Python, Node, Go, PHP, Ruby, and more.

  • Pay Per Valid Only

    Credits are only consumed when we return enriched data. Failed lookups cost nothing guaranteed.

// use cases

What teams build with Enrichment

// customers

Teams that run Enrichment every day

  • The enrichment data quality is excellent. Every lookup gives us job titles, company info, and social profiles.
    Steffen BurandtHead of Business Development
  • Stellar product and amazing support. This one is far superior by far.
    Martin EbongueEntrepreneur, Genius Data Flow

// faq

Frequently Asked Questions

Still have questions? Visit the help center

// quick start

Make your first call in a minute

Free account, real API key, the same endpoints Enterprise customers use.

  1. 1Create a free account25 searches a month. No card.
  2. 2Copy your key and secretFrom API keys in the dashboard.
  3. 3Call the APIPaste the request; the answer is JSON.
Get free API keyRead the docs
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"
Response
200 OK· 1 search credit
{
  "data": {
    "email": "richard@piedpiper.com",
    "first_name": "Richard",
    "last_name": "Hendricks",
    "full_name": "Richard Hendricks",
    "website_url": "piedpiper.com",
    "company": "Pied Piper",
    "pattern": "{first}",
    "department": "executive",
    "type": "personal",
    "position": "CEO",
    "country": "US",
    "gender": "male",
    "twitter": null,
    "linkedin": "https://www.linkedin.com/in/richard-hendricks",
    "score": 100,
    "accept_all": false,
    "phone_number": true,
    "verification": {
      "date": "2025-01-15T10:32:00+01:00",
      "status": "valid"
    },
    "sources": [
      {
        "uri": "https://piedpiper.com/blog/engineering",
        "website_url": "piedpiper.com",
        "extracted_on": "2024-06-01T09:14:07+01:00",
        "last_seen_on": "2025-01-10T17:02:44+01:00",
        "still_on_page": true
      }
    ],
    "phone_data": []
  }
}