Skip to content

// get /v1/combined/find

Combined API

Get both person and company data from a single email address: social profiles, employment, firmographics, tech stack, and business metrics in one API call. A drop-in Clearbit Combined API replacement.

2 search credits

// api console

GETapi.tomba.io/v1/combined/find
Example
person.name.fullName
Abedrahim Ben Rebia
person.employment.title
Chief Executive Officer
person.verification.status
valid
company.name
Tomba
company.category.industry
Information Technology and Services
company.geo.city
Claymont
company.metrics.employees
1-10
company.foundedYear
2021

// 01 · request

Person + Company 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/combined/find
emailrequired
Work email
curl -G https://api.tomba.io/v1/combined/find \
  --data-urlencode "email=richard@piedpiper.com" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"

// 02 · response

What comes back

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

GET/combined/find
data.personobject
Name, employment, location, social handles, verification (as in Person Enrichment)
data.person.employmentobject
Company, domain, title, role, seniority
data.companyobject
Name, industry codes, location, metrics, tech (as in Company Enrichment)
data.company.categoryobject
Sector, industry, SIC and NAICS codes
meta.emailstring
The address you sent
errorsobject
When nothing is found the response is still 200, with errors {type, message, code} instead of data
GET /combined/find
200 OK
{
  "data": {
    "person": {
      "name": {
        "fullName": "Richard Hendricks",
        "givenName": "Richard",
        "familyName": "Hendricks"
      },
      "email": "richard@piedpiper.com",
      "location": "Palo Alto, California, United States",
      "gender": "male",
      "timeZone": "America/Los_Angeles",
      "utcOffset": -8,
      "geo": {
        "city": "Palo Alto",
        "state": "California",
        "stateCode": "CA",
        "country": "United States",
        "countryCode": "US",
        "lat": 37.4419,
        "lng": -122.143
      },
      "bio": "Founder of Pied Piper.",
      "site": "https://piedpiper.com",
      "avatar": null,
      "employment": {
        "domain": "piedpiper.com",
        "name": "Pied Piper",
        "title": "CEO",
        "role": "executive",
        "subRole": null,
        "seniority": "executive"
      },
      "facebook": {
        "handle": null
      },
      "github": {
        "handle": null,
        "id": null,
        "avatar": null,
        "company": null,
        "blog": null,
        "followers": null,
        "following": null
      },
      "twitter": {
        "handle": null,
        "id": null,
        "bio": null,
        "followers": null,
        "following": null,
        "statuses": null,
        "favorites": null,
        "location": null,
        "site": null,
        "avatar": null
      },
      "linkedin": {
        "handle": "in/richard-hendricks"
      },
      "gravatar": {
        "handle": null,
        "urls": null,
        "avatar": null,
        "avatars": null
      },
      "verification": {
        "date": "2025-01-15T10:32:00+01:00",
        "status": "valid"
      },
      "phone": true,
      "fuzzy": false,
      "emailProvider": "Google",
      "indexedAt": "2025-01-15T10:32:00+01:00",
      "activeAt": "2025-01-15T10:32:00+01:00",
      "inactiveAt": null
    },
    "company": {
      "name": "Pied Piper",
      "legalName": "Pied Piper, Inc.",
      "domain": "piedpiper.com",
      "domainAliases": [],
      "site": {
        "phoneNumbers": [],
        "emailAddresses": [
          "hello@piedpiper.com"
        ]
      },
      "category": {
        "sector": "Information Technology",
        "industryGroup": "Software & Services",
        "industry": "Internet Software & Services",
        "subIndustry": "Internet Software & Services",
        "sicCode": "73",
        "sic4Codes": [
          "7372"
        ],
        "naicsCode": "51",
        "naics6Codes": [
          "511210"
        ],
        "naics6Codes2022": [
          "513210"
        ]
      },
      "tags": [
        "Compression",
        "Decentralized internet"
      ],
      "description": "Middle-out compression for files and video.",
      "foundedYear": "2014",
      "location": "5230 Newell Road, Palo Alto, CA 94303, United States",
      "timeZone": "America/Los_Angeles",
      "utcOffset": -8,
      "geo": {
        "streetNumber": "5230",
        "streetName": "Newell Road",
        "subPremise": null,
        "streetAddress": "5230 Newell Road",
        "city": "Palo Alto",
        "postalCode": "94303",
        "state": "California",
        "stateCode": "CA",
        "country": "United States",
        "countryCode": "US",
        "lat": 37.4419,
        "lng": -122.143
      },
      "logo": "https://logo.tomba.io/piedpiper.com",
      "facebook": {
        "handle": null,
        "likes": null
      },
      "linkedin": {
        "handle": "company/pied-piper"
      },
      "twitter": {
        "handle": null,
        "id": null,
        "bio": null,
        "followers": null,
        "following": null,
        "location": null,
        "site": null,
        "avatar": null
      },
      "whois": {
        "registrar_name": null,
        "created_date": null,
        "referral_url": null
      },
      "emailProvider": "Google",
      "type": "private",
      "ticker": null,
      "identifiers": {
        "usEIN": null
      },
      "metrics": {
        "alexaUsRank": null,
        "alexaGlobalRank": null,
        "trafficRank": null,
        "employees": "11-50",
        "marketCap": null,
        "raised": null,
        "annualRevenue": null,
        "estimatedAnnualRevenue": null,
        "fiscalYearEnd": null
      },
      "indexedAt": "2025-01-15T10:32:00+01:00",
      "tech": [
        "google_apps",
        "intercom"
      ],
      "techCategories": [
        "email_hosting_service",
        "live_chat"
      ],
      "parent": {
        "domain": null
      },
      "ultimateParent": {
        "domain": null
      }
    }
  },
  "meta": {
    "email": "richard@piedpiper.com"
  }
}

// 03 · cost and limits

What a call costs

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

// cost

2search credit

Charged when: A person is returned.

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

Scroll sideways for every column

Pro Plus, Scale, Enterprise and credit packs of 50,000 or more: no limit on these endpoints. Daily limits reset at 00:00 UTC. Rate limits

// faq

Combined API questions

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.