> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seamless.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Data dictionary

> Every attribute on Seamless.AI contact and company records returned by the Research and My Data APIs, grouped by category.

These are the attributes returned by the [Contact Research](/api-catalog/contact-enrichment), [Company Research](/api-catalog/company-enrichment), [My Contact Data](/api-catalog/my-contact-data), and [My Company Data](/api-catalog/my-company-data) APIs. Any field can be `null` when Seamless has no value for it. Search results return a lighter subset, listed on each search product page.

> [!NOTE]
>
> Deprecated aliases such as `title`, `company`, and `companyStaffCountRange` are still returned for backward compatibility but are not listed here. Use the names below.

## Contact attributes

### Person

| Field | Type | Description |
| - | - | - |
| `firstName` | string | Contact's first name. |
| `middleName` | string | Contact's middle name, if available. |
| `lastName` | string | Contact's last name. |
| `fullName` | string | Contact's full display name (first + middle + last). |
| `nameOriginal` | string | Contact's name as originally sourced, before any normalization. |
| `jobTitle` | string | Contact's current job title. |
| `department` | string | Department the contact works in. |
| `seniority` | string | Seniority level: C-Level, VP, Director, Manager, Senior, Mid-Level, Entry Level, or Other. |
| `image` | string | URL to the contact's profile photo, if available. |

### Email

| Field | Type | Description |
| - | - | - |
| `email` | string | Primary email address selected for this contact. |
| `personalEmail` | string | Personal (non-work) email address, if available. |
| `emailDomain` | string | Domain portion of the contact's email address. |
| `email1` - `email3` | string | Up to three email addresses found for the contact. |
| `email1Selected` | boolean | Whether `email1` was selected as the primary email. |
| `email1TotalAI` - `email3TotalAI` | string | Confidence score (percentage) for each email. |
| `email1EmailAI` - `email3EmailAI` | string | Validation status for each email: valid, invalid, or risky. |

### Phone

| Field | Type | Description |
| - | - | - |
| `contactPhone1`, `contactPhone2` | string | Direct phone numbers for the contact. |
| `contactPhone1TotalAI` | string | Confidence score (percentage) for the primary contact phone. |
| `contactPhone1DataType`, `contactPhone2DataType` | string | Phone type, such as mobile or main. |
| `companyPhone1` - `companyPhone3` | string | Phone numbers for the contact's company. |
| `companyPhone1TotalAI` - `companyPhone3TotalAI` | string | Confidence score (percentage) for each company phone. |
| `companyPhone1DataType` - `companyPhone3DataType` | string | Phone type for each company phone. |

### Social

| Field | Type | Description |
| - | - | - |
| `lIProfileUrl` | string | Contact's LinkedIn public profile URL. |
| `lISalesNavUrl` | string | Contact's LinkedIn Sales Navigator profile URL. |
| `lIRecruiterUrl` | string | Contact's LinkedIn Recruiter profile URL. |

### Location

| Field | Type | Description |
| - | - | - |
| `contactLocation` | object | Contact location: `city`, `state`, `stateAbbr`, `postCode`, `county`, `country`, `countryAlpha2`, `countryAlpha3`, `countryNumeric`, `fullString`, `timezone`, `timezoneAbbr`, `timezoneRawOffset`. |
| `companyLocation` | object | Company headquarters address: `street1`-`street3`, `city`, `state`, `stateAbbr`, `postCode`, `county`, `country`, ISO country codes, `fullString`. |
| `city`, `state`, `country` | string | Flat copies of the contact's location. |
| `companyCity`, `companyState`, `companyCountry` | string | Flat copies of the company headquarters location. |
| `timezone`, `timezoneAbbr` | string | The contact's local timezone. |
| `localTime` | string | The contact's local time when the response was generated (ISO 8601 with UTC offset). |

### Tenure and job changes

| Field | Type | Description |
| - | - | - |
| `startedAtCurrentCompany` | string | Date the contact started at their current company (YYYY-MM-DD). |
| `titleStartedAt` | string | Date the contact started their current title (YYYY-MM-DD). |
| `timeAtRole` | string | Human-readable tenure in the current role, for example "1 Yr 2 Mo". |
| `timeAtCompany` | string | Human-readable tenure at the current company. |
| `formerCompany`, `formerTitle` | string | Most recent previous employer and title. |
| `formerStartedAt`, `formerEndedAt` | string | Start and end dates of the previous role (YYYY-MM-DD). |
| `jobHistory` | array | Prior roles, most recent first: `companyName`, `title`, `startedAt`, `endedAt`. |
| `jobChangeAlert` | string | Type of job change detected in the job change date range. |

### Company

| Field | Type | Description |
| - | - | - |
| `companyName` | string | Current company name of the contact. |
| `companyOriginal` | string | Company name as originally sourced, before normalization. |
| `companyDescription` | string | Description of the contact's company. |
| `companyFounded` | string | Year the company was founded. |
| `companyIndustry` | string | Industry classification of the company. |
| `sicCode`, `naicsCode` | string | SIC and NAICS industry codes. |
| `companyStaffCount` | integer | Approximate number of employees. |
| `companySize` | string | Employee count range, same values as the `companySize` search filter. |
| `companyAnnualRevenue` | string | Estimated annual revenue in USD. |
| `companyRevenue` | string | Revenue range, same values as the `companyRevenue` search filter. |
| `companyDomain`, `website` | string | Primary website domain of the company. |
| `companyLIProfileUrl` | string | LinkedIn company page URL. |
| `companyLinkedInId` | string | LinkedIn numeric identifier for the company. |

### Signals

| Field | Type | Description |
| - | - | - |
| `companyType` | string | `Public` or `Private`. |
| `stockTicker` | string | Stock ticker, if publicly traded. |
| `newsAndEvents` | array | Recent company news: `title`, `url`, `date`, `type` (for example Acquisition). |
| `companyFundingTotal` | string | Latest total funding amount. |
| `companyLatestFundingDate` | string | Date of the latest funding round (YYYY-MM-DD). |
| `companyLatestFundingClassifications` | array | Classifications of the latest round, for example Series A. |

### Record metadata

| Field | Type | Description |
| - | - | - |
| `contactId` | string | Unique identifier for the contact record in your org. |
| `username` | string | Email of the Seamless.AI user who researched the contact. |
| `createdAt`, `updatedAt` | string | When the record was created and last updated. |
| `apiResearchId` | string | The `requestId` from `/contacts/research`, to match results to requests. |

### Research links

Ready-made URLs for further research on the contact and company: `advertisingIntelligence`, `alexaScore`, `companyNews`, `employeeReviews`, `googleFinance`, `googleResearch`, `jobPostings`, `localSportsTeams`, `localWeather`, `paidSearchIntelligence`, `paidSearchKeywordsIntelligence`, `searchMarketingIntelligence`, `secFilings`, `seoResearch`, `similarWebsites`, `socialMediaMentions`, `socialMediaPosts`, `socialPosts`, `websiteAudit`, `websiteAudit2`, `websiteGrader`, `webTechnologies`, `whois`, `wikipedia`, `yahooFinance`.

## Company attributes

### Firmographics

| Field | Type | Description |
| - | - | - |
| `companyName` | string | Canonical company name. |
| `domain` | string | Primary website domain. |
| `description` | string | Company profile description. |
| `foundedOn` | string | Founding date, when available. |
| `industries` | string | Comma-separated industry labels. |
| `sicCode`, `naicsCode` | string | SIC and NAICS industry codes. |
| `staffCount` | string | Estimated number of employees. |
| `companySize` | string | Employee count range. |
| `annualRevenue` | string | Estimated annual revenue. |
| `companyRevenue` | string | Revenue range. |
| `topTechnologies` | string | Comma-separated list of top detected technologies. |

### Phone

| Field | Type | Description |
| - | - | - |
| `phones` | string | Comma-separated company phone numbers. |
| `phoneTypes` | string | Comma-separated phone types, in the same order as `phones`. |
| `phonesAiScores` | string | Comma-separated confidence scores, in the same order as `phones`. |

### Social and location

| Field | Type | Description |
| - | - | - |
| `linkedInProfileUrl` | string | LinkedIn company profile URL. |
| `linkedInId` | string | LinkedIn company identifier. |
| `location` | object | Headquarters address. |

### Signals

| Field | Type | Description |
| - | - | - |
| `companyType` | string | `Public` or `Private`. |
| `stockTicker` | string | Stock ticker, if publicly traded. |
| `newsAndEvents` | array | Recent company news: `title`, `url`, `date`, `type`. |
| `fundingTotal` | string | Latest total funding amount. |
| `latestFundingDate` | string | Date of the latest funding round (YYYY-MM-DD). |
| `latestFundingClassifications` | array | Classifications of the latest round, for example Series A. |

### Record metadata

| Field | Type | Description |
| - | - | - |
| `apiResearchId` | string | The `requestId` from `/companies/research`. |
| `username` | string | The org user the record belongs to. |
| `createdAt`, `updatedAt` | string | When the record was created and last updated. |
| `researchedAt` | string | When the company was most recently researched. |

### Research links

`advertisingIntelligenceUrl`, `alexaScoreUrl`, `employeeReviewsUrl`, `googleFinanceUrl`, `googleResearchUrl`, `intelUrl`, `jobPostingsUrl`, `localSportsTeamsUrl`, `localWeatherUrl`, `newsUrl`, `paidSearchIntelligenceUrl`, `paidSearchKeywordsIntelligenceUrl`, `searchMarketingIntelligenceUrl`, `secFilingsUrl`, `seoResearchUrl`, `similarWebsitesUrl`, `socialMediaMentionsUrl`, `socialMediaPostsUrl`, `socialPostsUrl`, `tweetsUrl`, `webTechnologiesUrl`, `websiteAuditUrl`, `websiteAudit2Url`, `websiteGraderUrl`, `whoisUrl`, `wikipediaUrl`, `yahooFinanceUrl`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.