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. |
| 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 |