Enrichment
Person and company profiles in a Clearbit-compatible format
Company API
Returns the company behind a domain in Clearbit's Company API format: name, description, location, industry codes, social handles, size, revenue, and technologies. Fields that Tomba doesn't fill are always null; see Clearbit-compatible enrichment.
When there's no match, the response has status 200 with an errors object instead of data: type not_found (code 404) when Tomba has no record of the domain, and params_invalid (code 422) for a disposable or webmail domain. Check for errors before you read data. See Credits and usage for when a request is charged.
query Parameters
domainThe company domain, such as stripe.com.
Company API › Responses
The company, or an errors object with status 200 when there's no match.
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: data, meta | |
| type = object · requires: errors |
A company in Clearbit's field format. Fields Tomba doesn't fill are always null: domainAliases, timeZone, utcOffset, logo, ticker, identifiers.usEIN, category.sector, category.industryGroup, category.industry, category.subIndustry, geo.subPremise, geo.lat, geo.lng, facebook.likes, every twitter field except handle, metrics.alexaUsRank, metrics.alexaGlobalRank, metrics.marketCap, metrics.raised, metrics.fiscalYearEnd, parent.domain, and ultimateParent.domain. See Clearbit-compatible enrichment.
The lookup.
Person API
Returns the person behind an email address in Clearbit's Person API format: name, location, employment, and social profiles. Fields that Tomba doesn't fill are always null; see Clearbit-compatible enrichment. For Tomba's own format, use Email Enrichment.
When there's no match, the response has status 200 with an errors object instead of data: type not_found (code 404) when Tomba has no data for the address, and params_invalid (code 422) for a disposable or webmail address. Check for errors before you read data. See Credits and usage for when a request is charged.
query Parameters
emailThe email address to look up.
webhook_urlOptional URL that also receives the result in a POST request when the result qualifies. The response body is returned either way. See Webhooks.
Person API › Responses
The person, or an errors object with status 200 when there's no match.
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: data, meta | |
| type = object · requires: errors |
A person in Clearbit's field format. Fields Tomba doesn't fill are always null: timeZone, utcOffset, bio, site, avatar, fuzzy, emailProvider, activeAt, inactiveAt, geo.city, geo.state, geo.stateCode, geo.lat, geo.lng, employment.subRole, employment.seniority, facebook.handle, every github and gravatar field, and every twitter field except handle. See Clearbit-compatible enrichment.
The lookup.
Combined API
Returns the person behind an email address and the company behind its domain in one call, in Clearbit's format: data.person has the Person API fields and data.company the Company API fields. When Tomba has no record of the domain, every company field is null and meta.email is empty.
When there's no match for the person, the response has status 200 with an errors object instead of data: type not_found (code 404) when Tomba has no data for the address, and params_invalid (code 422) for a disposable or webmail address. Check for errors before you read data. See Credits and usage for when a request is charged.
query Parameters
emailThe email address to look up.
webhook_urlOptional URL that also receives the result in a POST request when the result qualifies. The response body is returned either way. See Webhooks.
Combined API › Responses
The person and the company, or an errors object with status 200 when there's no match.
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: data, meta | |
| type = object · requires: errors |
The person and the company.
The lookup.