# Enrichment Attributes

Our Enrichment endpoints allow you to retrieve all the information we have about an email address, a company, or both.

The response is formatted according to Clearbit's schema.

## Person API

The **Person Enrichment API** returns detailed information about a person and their online profiles based on their email address.

---

### Personal Identity

| Attribute    | Description                    |
| ------------ | ------------------------------ |
| `fullName`   | Full name of the person        |
| `givenName`  | First name                     |
| `familyName` | Last name                      |
| `email`      | Email address                  |
| `gender`     | Gender (if detectable)         |
| `bio`        | Short biography                |
| `site`       | Personal website               |
| `avatar`     | Profile picture (if available) |

---

### Location & Time

| Attribute   | Description         |
| ----------- | ------------------- |
| `location`  | Country code        |
| `timeZone`  | Time zone           |
| `utcOffset` | UTC offset from GMT |

#### Geo Breakdown

| Geo Field     | Description            |
| ------------- | ---------------------- |
| `city`        | City name              |
| `state`       | Full state name        |
| `stateCode`   | Abbreviated state code |
| `country`     | Full country name      |
| `countryCode` | ISO country code       |
| `lat`         | Latitude               |
| `lng`         | Longitude              |

---

### Employment Details

| Attribute   | Description                          |
| ----------- | ------------------------------------ |
| `domain`    | Company domain                       |
| `name`      | Company name                         |
| `title`     | Person’s job title                   |
| `role`      | Department or role area              |
| `subRole`   | Sub-category of role (if applicable) |
| `seniority` | Seniority level within the company   |

---

### Social & Developer Profiles

| Platform     | Attribute |
| ------------ | --------- |
| **Twitter**  | `handle`  |
| **Facebook** | `handle`  |
| **LinkedIn** | `handle`  |
| **GitHub**   | `handle`  |
| **Gravatar** | `handle`  |

---

### Other Fields

| Attribute       | Description                                   |
| --------------- | --------------------------------------------- |
| `phone`         | Whether a phone number is associated          |
| `indexedAt`     | Timestamp of when the record was last updated |
| `activeAt`      | Timestamp of last known activity              |
| `inactiveAt`    | Timestamp of when user became inactive        |
| `fuzzy`         | Whether the match was a fuzzy match           |
| `emailProvider` | Email provider type (e.g. Gmail, Outlook)     |

---

## Company API

Tomba’s **Company Enrichment API** returns detailed company-level data based on a domain. It includes metadata, technologies used, contact information, industry classification, social links, and more.

---

### Core Company Details

| Attribute       | Description                             |
| --------------- | --------------------------------------- |
| `id`            | Unique company ID                       |
| `name`          | Public company name                     |
| `legalName`     | Legal entity name                       |
| `domain`        | Primary domain name                     |
| `domainAliases` | Alternate domains (if any)              |
| `description`   | Short description of the company        |
| `type`          | Type of company (e.g., private, public) |
| `foundedYear`   | Year the company was founded            |
| `location`      | Full textual HQ location                |
| `timeZone`      | Time zone of the HQ                     |
| `utcOffset`     | Time zone offset from UTC               |
| `indexedAt`     | Date when the data was last indexed     |
| `emailProvider` | Provider that hosts the email services  |
| `phone`         | Main business contact phone             |

---

### Location Details

| Field         | Description            |
| ------------- | ---------------------- |
| `city`        | City of headquarters   |
| `state`       | Full state name        |
| `stateCode`   | State abbreviation     |
| `country`     | Country                |
| `countryCode` | ISO country code       |
| `lat` / `lng` | Latitude and longitude |

---

### Contact Information

| Field                 | Description               |
| --------------------- | ------------------------- |
| `site.phoneNumbers`   | List of phone numbers     |
| `site.emailAddresses` | All known email addresses |

---

### Industry Classification

| Field                        | Description              |
| ---------------------------- | ------------------------ |
| `category.sector`            | Sector name              |
| `category.industryGroup`     | Industry group           |
| `category.industry`          | Specific industry        |
| `category.subIndustry`       | Sub-industry             |
| `category.gicsCode`          | GICS classification code |
| `category.sicCode`           | SIC primary code         |
| `category.sic4Codes[]`       | SIC 4-digit codes        |
| `category.naicsCode`         | NAICS primary code       |
| `category.naics6Codes[]`     | NAICS 6-digit codes      |
| `category.naics6Codes2022[]` | NAICS (2022) codes       |

---

### Tags

| Field    | Description                          |
| -------- | ------------------------------------ |
| `tags[]` | Keywords or tags describing business |

---

### Brand & Social Profiles

| Platform            | Attribute             | Example |
| ------------------- | --------------------- | ------- |
| `logo`              | Logo image URL        |
| `facebook.handle`   | Facebook page ID      |
| `linkedin.handle`   | LinkedIn company path |
| `twitter.handle`    | Twitter username      |
| `crunchbase.handle` | Crunchbase identifier |

---

### Metrics

| Metric                   | Description                         |
| ------------------------ | ----------------------------------- |
| `trafficRank`            | Web traffic level (e.g., very_high) |
| `employees`              | Company size category               |
| `marketCap`              | Market capitalization               |
| `raised`                 | Total funds raised                  |
| `annualRevenue`          | Verified revenue (if available)     |
| `estimatedAnnualRevenue` | Estimated revenue                   |
| `fiscalYearEnd`          | Fiscal year-end month/date          |

---

### Parent Relationships

| Field                   | Description                     |
| ----------------------- | ------------------------------- |
| `parent.domain`         | Immediate parent company domain |
| `ultimateParent.domain` | Ultimate holding company        |

---

### Technology Stack

| Field              | Description                                   |
| ------------------ | --------------------------------------------- |
| `tech[]`           | List of detected technologies used by company |
| `techCategories[]` | Categories of technologies in use             |

---

### Notes

- Multiple **email addresses** are returned from publicly available sources and records.
- Tech stack detection is powered by Tomba’s proprietary crawling engine.
- Fields may return `null` if data is unavailable or not detected.

---

This data is ideal for enriching CRM systems, lead profiling, competitive research, and personalization at scale.

## Combined API

The **Combined Enrichment API** aggregates both **Email Enrichment** and **Company Enrichment** data into a single structured response, allowing you to retrieve complete person and company metadata using only an email address.

---

### Structure

The response includes two primary objects under the `data` key:

| Field     | Description                                                         |
| --------- | ------------------------------------------------------------------- |
| `person`  | Contains all person-level data (same as Email Enrichment)           |
| `company` | Contains all domain/company-level data (same as Company Enrichment) |

---

### Data Composition

- `person`: Includes name, role, social profiles, location, and employment metadata. See [Person API](#person-api).
- `company`: Includes company name, description, size, industry classifications, contact info, social links, and technologies used. See [Company API](#company-api).