Clearbit-compatible enrichment
Returned by GET /people/find, GET /companies/find, and GET /combined/find. These endpoints use Clearbit's field names; the Clearbit migration guide maps them. For Tomba's own format, use email enrichment.
When there's no match, these endpoints return status 200 with an errors object instead of data: type not_found when Tomba has no record, and params_invalid for a disposable or webmail address or domain. Check for errors before you read data; see Errors.
Person fields
GET /people/find returns these fields at data, and the address you looked up at meta.email.
| Field | Type | Description |
|---|---|---|
email | string | The email address. |
name.fullName, name.givenName, name.familyName | string | Full, first, and last name. |
gender | string or null | male or female. |
location | string or null | Two-letter country code. Clearbit returns a full location here. |
geo.country | string | Country name, such as United States. |
geo.countryCode | string or null | Two-letter country code. |
employment.domain | string | Employer's domain. |
employment.name | string or null | Employer's name. |
employment.title | string or null | Job title. |
employment.role | string or null | Department, such as engineering. See Departments. |
linkedin.handle | string or null | LinkedIn profile URL. Clearbit returns a handle here. |
twitter.handle | string or null | Twitter (X) profile URL. Clearbit returns a handle here. |
phone | boolean | true when Tomba has a phone number for the person. |
verification.status, verification.date | string or null | Tomba's last check of the address, as in the person response. Not a Clearbit field. |
indexedAt | string | When Tomba last updated the record, in RFC 3339 format. |
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 field, every gravatar field, and every twitter field except handle.
Company fields
GET /companies/find returns these fields at data, and the domain you looked up at meta.domain.
| Field | Type | Description |
|---|---|---|
name | string or null | Company name. legalName has the same value. |
domain | string | The domain. |
description | string or null | Short description of the company. |
foundedYear | string or null | Year founded. |
type | string or null | Company type, in the same form as company_type in the company response. |
tags | array of strings or null | Keywords that describe the company. |
location | string or null | Two-letter country code of the headquarters. |
geo.country | string | Country name. |
geo.countryCode | string or null | Two-letter country code. |
geo.city, geo.state, geo.postalCode | string or null | City, state or region, and postal code. geo.stateCode repeats geo.state. |
geo.streetAddress | string or null | Street address. geo.streetNumber and geo.streetName repeat it. |
site.phoneNumbers | array of strings or null | The company's phone number, if Tomba has one. |
site.emailAddresses | array of strings or null | Generic (role) addresses at the domain. |
category.sicCode, category.sic4Codes | string or null, array or null | SIC codes. See SIC codes. |
category.naicsCode, category.naics6Codes, category.naics6Codes2022 | string or null, array or null | NAICS codes. See NAICS codes. |
metrics.employees | string or null | Employee count range, as in company_size. |
metrics.annualRevenue | string or null | Estimated annual revenue range. metrics.estimatedAnnualRevenue has the same value. |
metrics.trafficRank | string or null | Popularity rank of the domain on the web, as a number in a string. Lower is more popular. Clearbit returns a label such as very_high here. |
facebook.handle, linkedin.handle, twitter.handle | string or null | Handles of the company's profiles. |
emailProvider | string or null | Mail provider detected from the domain's MX records, such as Google. |
tech | array of strings or null | Names of the technologies detected on the website. See Technology response. |
techCategories | array of strings or null | Categories of those technologies. |
whois | object | Domain registration, with snake_case keys. See WHOIS. Not a Clearbit field. |
indexedAt | string | When Tomba last updated the record, in RFC 3339 format. |
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. For the industry, use industries from domain search; for the logo, use the Logo API.
Combined fields
GET /combined/find returns the person fields at data.person, the company fields for the address's domain at data.company, and the address at meta.email. When Tomba has no record for the domain, every company field is null and meta.email is empty.
Example
GET /people/find?email=jane.doe@stripe.com:
Code
GET /companies/find?domain=stripe.com:
Code