> ## 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](https://docs.seamless.ai/api-catalog/contact-enrichment.md), [Company Research](https://docs.seamless.ai/api-catalog/company-enrichment.md), [My Contact Data](https://docs.seamless.ai/api-catalog/my-contact-data.md), and [My Company Data](https://docs.seamless.ai/api-catalog/my-company-data.md) APIs. Most fields can be `null` when Seamless has no value for it; identifiers and timestamps (for example `contactId`, `createdAt`, `updatedAt`) are always present. Search results return a lighter subset, listed on each search product page.

## 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). |
| `name` | string | Contact's display name. |
| `nameOriginal` | string | Contact's name as originally sourced, before any normalization. |
| `jobTitle` | string | Contact's current job title. Same vocabulary as the `jobTitle` search filter. |
| `department` | string | Department the contact works in. |
| `seniority` | string | Seniority level of the contact's role (e.g., C-Level, VP, Director, Manager, Senior, Entry Level). |
| `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, if available. |
| `email1` | string | First email address found for the contact (typically the primary/selected email). |
| `email1Selected` | boolean | Whether this email was selected as the primary email for the contact. |
| `email1TotalAI` | string | Confidence score (percentage) for the first email address. |
| `email1EmailAI` | string | Email validation status for the first email address (e.g., valid, invalid, risky). |
| `email2` | string | Second email address found for the contact. |
| `email2TotalAI` | string | Confidence score (percentage) for the second email address. |
| `email2EmailAI` | string | Email validation status for the second email address. |
| `email3` | string | Third email address found for the contact. |
| `email3TotalAI` | string | Confidence score (percentage) for the third email address. |
| `email3EmailAI` | string | Email validation status for the third email address. |

### Phone

| Field | Type | Description |
| - | - | - |
| `contactPhone1` | string | Primary direct phone number for the contact. |
| `contactPhone1TotalAI` | string | Confidence score (percentage) for the primary contact phone number. |
| `contactPhone1DataType` | string | Type classification of the primary contact phone (e.g., mobile, main). |
| `contactPhone2` | string | Secondary direct phone number for the contact. |
| `contactPhone2DataType` | string | Type classification of the secondary contact phone. |
| `companyPhone1` | string | Primary phone number for the contact's company. |
| `companyPhone1TotalAI` | string | Confidence score (percentage) for the primary company phone number. |
| `companyPhone1DataType` | string | Type classification of the primary company phone. |
| `companyPhone2` | string | Secondary phone number for the contact's company. |
| `companyPhone2TotalAI` | string | Confidence score (percentage) for the secondary company phone number. |
| `companyPhone2DataType` | string | Type classification of the secondary company phone. |
| `companyPhone3` | string | Tertiary phone number for the contact's company. |
| `companyPhone3TotalAI` | string | Confidence score (percentage) for the tertiary company phone number. |
| `companyPhone3DataType` | string | Type classification of the tertiary 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 | Geographic location of the contact. Fields: `city`, `state`, `postCode`, `county`, `country`, `stateAbbr`, `countryAbbr`, `countryAlpha2`, `countryAlpha3`, `countryNumeric`, `fullString`, `timezone`, `timezoneRawOffset`, `timezoneAbbr`. |
| `companyLocation` | object | Headquarters or primary office address of the contact's company. Fields: `street1`, `street2`, `street3`, `city`, `state`, `postCode`, `county`, `country`, `stateAbbr`, `countryAbbr`, `countryAlpha2`, `countryAlpha3`, `countryNumeric`, `fullString`. |
| `city` | string | The city where the contact is located. Flat mirror of `contactLocation.city`, provided for consistency with the search endpoint. |
| `state` | string | The state or region where the contact is located. Flat mirror of `contactLocation.state`, provided for consistency with the search endpoint. |
| `country` | string | The country where the contact is located. Flat mirror of `contactLocation.country`, provided for consistency with the search endpoint. |
| `companyCity` | string | The city where the contact's company headquarters is located. Flat mirror of `companyLocation.city`, provided for consistency with the search endpoint. |
| `companyState` | string | The state or region where the contact's company headquarters is located. Flat mirror of `companyLocation.state`, provided for consistency with the search endpoint. |
| `companyCountry` | string | The country where the contact's company headquarters is located. Flat mirror of `companyLocation.country`, provided for consistency with the search endpoint. |
| `timezone` | string | The contact's local timezone (name with abbreviation). Flat mirror of `contactLocation.timezone`, consistent with the search endpoint. |
| `timezoneAbbr` | string | The contact's local timezone abbreviation. Flat mirror of `contactLocation.timezoneAbbr`. |
| `localTime` | string | The contact's current local time when the response was generated, as an ISO 8601 timestamp with the timezone's 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 contact's current role, derived from `titleStartedAt` (e.g. "1 Yr 2 Mo", "3 Mo"). |
| `timeAtCompany` | string | Human-readable tenure at the contact's current company, derived from `startedAtCurrentCompany` (e.g. "1 Yr 2 Mo", "3 Mo"). |
| `formerCompany` | string | Name of the contact's most recent previous employer. |
| `formerTitle` | string | Job title at the contact's most recent previous employer. |
| `formerStartedAt` | string | Date the contact started at their former company (YYYY-MM-DD). |
| `formerEndedAt` | string | Date the contact left their former company (YYYY-MM-DD). |
| `jobHistory` | object\[] | The contact's prior roles, most recent departure first. The current role is not included here — it is carried by `companyName` (`company`), `jobTitle` (`title`), `startedAtCurrentCompany` and `titleStartedAt` — and `formerCompany`/`formerTitle` mirror the first entry. Returned by `POST /contacts/research` (via `GET /contacts/research/poll`); a contact with no known prior roles gets an empty array, never `null` or a missing key. Fields: `companyName`, `title`, `startedAt`, `endedAt`. |
| `jobChangeAlert` | string | Type of job change detected given provided or default job change date range. When detected; 'New Hire' = joined a new company, 'New Promotion' = new role at the same company. |

### Company

| Field | Type | Description |
| - | - | - |
| `companyName` | string | Current company name of the contact. Same vocabulary as the `companyName` search filter. |
| `companyOriginal` | string | Company name as originally sourced, before any normalization. |
| `companyDescription` | string | Description or summary of the contact's company. |
| `companyFounded` | string | Year the company was founded. |
| `companyIndustry` | string | Industry classification of the contact's company. |
| `sicCode` | string | Standard Industrial Classification (SIC) code for the contact's company. |
| `naicsCode` | string | North American Industry Classification System (NAICS) code for the contact's company. |
| `companyStaffCount` | integer | Approximate total number of employees at the company. |
| `companySize` | string | Employee count range of the contact's company. Same vocabulary as the `companySize` search filter. |
| `companyAnnualRevenue` | string | Estimated annual revenue in USD (numeric string). |
| `companyRevenue` | string | Revenue range bucket for the contact's company. Same vocabulary as the `companyRevenue` search filter. |
| `companyDomain` | string | Primary website domain of the company. |
| `website` | string | Company website domain. |
| `companyLIProfileUrl` | string | LinkedIn company page URL. |
| `companyLinkedInId` | string | LinkedIn numeric identifier for the company. |

### Signals

| Field | Type | Description |
| - | - | - |
| `companyType` | string | Company type — "Public" or "Private" when determined. |
| `stockTicker` | string | Stock ticker symbol of the company, if publicly traded. |
| `newsAndEvents` | object\[] | Recent news articles related to the company. Fields: `title`, `url`, `date`, `type`. |
| `companyFundingTotal` | string | The latest total funding amount for the company. |
| `companyLatestFundingDate` | string | The date of the latest funding round for the company (formatted as "YYYY-MM-DD"). |
| `companyLatestFundingClassifications` | string\[] | The classifications of the latest funding round for the company (e.g., "Series A", "Pre-Seed", etc.). |

### Record metadata

| Field | Type | Description |
| - | - | - |
| `contactId` | string | Unique identifier for this contact record. |
| `username` | string | Email address of the Seamless.AI user who researched this contact. |
| `createdAt` | string | Timestamp when this contact record was created. |
| `updatedAt` | string | Timestamp when this contact record was last updated. |
| `apiResearchId` | string | The request ID returned from the /contacts/research endpoint. Use this to correlate research requests with results. |

### Research links

Ready-made URLs for further research on the contact and company.

| Field | Type | Description |
| - | - | - |
| `advertisingIntelligence` | string | URL to advertising intelligence data for the contact's company. |
| `alexaScore` | string | URL to Alexa site information for the company domain. |
| `companyNews` | string | URL to Google News search results for the company. |
| `employeeReviews` | string | URL to Glassdoor employee reviews for the company. |
| `googleFinance` | string | URL to Google Finance page for the company. |
| `googleResearch` | string | URL to a Google search for the contact at their company. |
| `jobPostings` | string | URL to Glassdoor job postings for the company. |
| `localSportsTeams` | string | URL to a Google search for local sports teams near the company HQ. |
| `localWeather` | string | URL to a Google search for weather near the company HQ. |
| `paidSearchIntelligence` | string | URL to SEMrush paid search data for the company domain. |
| `paidSearchKeywordsIntelligence` | string | URL to KeywordSpy keyword research for the company domain. |
| `searchMarketingIntelligence` | string | URL to iSpionage search marketing data for the company domain. |
| `secFilings` | string | URL to SEC EDGAR filings for the company. |
| `seoResearch` | string | URL to Ahrefs SEO data for the company domain. |
| `similarWebsites` | string | URL to find websites similar to the company domain. |
| `socialMediaMentions` | string | URL to social media mention tracking for the company domain. |
| `socialMediaPosts` | string | URL to social media post search for the company domain. |
| `socialPosts` | string | URL to blog/social post search for the contact. |
| `websiteAudit` | string | URL to SimilarWeb traffic analysis for the company domain. |
| `websiteAudit2` | string | URL to WooRank website audit for the company domain. |
| `websiteGrader` | string | URL to HubSpot Website Grader analysis for the company domain. |
| `webTechnologies` | string | URL to BuiltWith technology lookup for the company domain. |
| `whois` | string | URL to WHOIS domain registration lookup for the company domain. |
| `wikipedia` | string | URL to the Wikipedia page for the company, if available. |
| `yahooFinance` | string | URL to Yahoo Finance page for the company. |

## Company attributes

### Firmographics

| Field | Type | Description |
| - | - | - |
| `companyName` | string | Canonical company name. Same vocabulary as the `companyName` search filter. |
| `domain` | string | Primary website domain of the company. |
| `description` | string | Company profile description text. |
| `foundedOn` | string | Year the company was founded, when available. |
| `industries` | string | Comma-separated industry labels for the company. |
| `sicCode` | string | Standard Industrial Classification (SIC) code. |
| `naicsCode` | string | North American Industry Classification System (NAICS) code. |
| `staffCount` | string | Estimated staff count value. |
| `companySize` | string | Staff count range bucket. Same vocabulary as the `companySize` search filter. |
| `annualRevenue` | string | Estimated annual revenue value. |
| `companyRevenue` | string | Revenue range bucket for the company. Same vocabulary as the `companyRevenue` search filter. |
| `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 aligned by position with `phones`. |
| `phonesAiScores` | string | Comma-separated AI confidence scores for each phone number in `phones`. |

### Social and location

| Field | Type | Description |
| - | - | - |
| `linkedInProfileUrl` | string | LinkedIn company profile URL. |
| `linkedInId` | string | LinkedIn company identifier. |
| `location` | object | Headquarters address of the company. Fields: `street1`, `street2`, `street3`, `city`, `state`, `stateAbbr`, `postCode`, `country`, `countryAbbr`, `countryAlpha2`, `countryAlpha3`, `countryNumeric`, `fullString`, `id`. |

### Signals

| Field | Type | Description |
| - | - | - |
| `companyType` | string | Company type — "Public" or "Private" when determined. |
| `stockTicker` | string | Stock ticker symbol of the company, if publicly traded. |
| `newsAndEvents` | object\[] | Recent news articles related to the company. Fields: `title`, `url`, `date`, `type`. |
| `fundingTotal` | string | The latest total funding amount for the company. |
| `latestFundingDate` | string | The date of the latest funding round for the company (formatted as "YYYY-MM-DD"). |
| `latestFundingClassifications` | string\[] | The classifications of the latest funding round for the company (e.g., "Series A", "Pre-Seed", etc.). |

### Record metadata

| Field | Type | Description |
| - | - | - |
| `apiResearchId` | string | The API research identifier for companies created through API research |
| `username` | string | Username of the org user the company record belongs to. |
| `createdAt` | string | Timestamp when this company record was created. |
| `updatedAt` | string | Timestamp when this company record was last updated. |
| `researchedAt` | string | Timestamp when the company was most recently researched. |

### Research links

Ready-made URLs for further research on the company.

| Field | Type | Description |
| - | - | - |
| `advertisingIntelligenceUrl` | string | URL to advertising intelligence data for the company. |
| `alexaScoreUrl` | string | URL to Alexa score and rank details. |
| `employeeReviewsUrl` | string | URL to employee reviews intelligence. |
| `googleFinanceUrl` | string | URL to Google Finance data for the company. |
| `googleResearchUrl` | string | URL to Google research/profile results for the company. |
| `intelUrl` | string | URL to general company intelligence overview. |
| `jobPostingsUrl` | string | URL to job posting intelligence for the company. |
| `localSportsTeamsUrl` | string | URL to local sports context for the company location. |
| `localWeatherUrl` | string | URL to local weather context for the company location. |
| `newsUrl` | string | URL to aggregated company news. |
| `paidSearchIntelligenceUrl` | string | URL to paid search intelligence details. |
| `paidSearchKeywordsIntelligenceUrl` | string | URL to paid search keyword intelligence details. |
| `searchMarketingIntelligenceUrl` | string | URL to search marketing intelligence details. |
| `secFilingsUrl` | string | URL to SEC filings and regulatory disclosures. |
| `seoResearchUrl` | string | URL to SEO research and metrics. |
| `similarWebsitesUrl` | string | URL to similar websites intelligence. |
| `socialMediaMentionsUrl` | string | URL to social media mentions analytics. |
| `socialMediaPostsUrl` | string | URL to social media posts analytics. |
| `socialPostsUrl` | string | URL to general social posts aggregation. |
| `tweetsUrl` | string | URL to aggregated tweets/X posts for the company. |
| `webTechnologiesUrl` | string | URL to web technologies intelligence. |
| `websiteAuditUrl` | string | URL to website audit results. |
| `websiteAudit2Url` | string | URL to secondary website audit data. |
| `websiteGraderUrl` | string | URL to website grader report. |
| `whoisUrl` | string | URL to WHOIS domain registration details. |
| `wikipediaUrl` | string | URL to the company Wikipedia page, when available. |
| `yahooFinanceUrl` | string | URL to Yahoo Finance profile/data. |

## Deprecated fields

These older field names are still returned for backward compatibility, so existing integrations keep working. Use the new names in new code.

| Deprecated field | Use instead | Returned by |
| - | - | - |
| `name` | `fullName` | Contact search |
| `fullname` | `fullName` | Contact search |
| `company` | `companyName` | Contact search, Contact research, My Contact Data |
| `title` | `jobTitle` | Contact search, Contact research, My Contact Data |
| `employeeSizeRange` | `companySize` | Contact search |
| `companyStaffCountRange` | `companySize` | Contact research, My Contact Data |
| `companyRevenueRange` | `companyRevenue` | Contact research, My Contact Data |
| `name` | `companyName` | Company search, Company research |
| `revenueRange` | `companyRevenue` | Company search, Company research |
| `staffCountRange` | `companySize` | Company search, Company research |


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