--- title: "Poll Contact Research" method: GET path: "/contacts/research/poll" tags: ["Contact Research"] --- # Poll Contact Research `GET /contacts/research/poll` Get the results/status of a contact research request ## Query parameters - `requestIds` string[], required ## Response `200` Poll Results - object - `success` boolean — Indicates whether the poll request was processed successfully. - `data` object[] — Array of research result objects, one per requested ID. - `requestId` string — The research request ID that was polled. - `searchResultId` string — The search result ID associated with this research request, if applicable. - `status` string — Current status of the research request. Common values include `queued`, `researching`, `done`, `error`, `missing`, `duplicate`, `not found`, `contact-already-researched`, and `No license or credits available`. Additional values may be returned over time. - `message` string — Additional status message, typically populated when the status is error or missing. - `contact` object — Full contact record returned by the Seamless.AI research engine. - `contactId` string — Unique identifier for this contact record. - `username` string — Email address of the Seamless.AI user who researched this contact. - `createdAt` string, date-time — Timestamp when this contact record was created. - `updatedAt` string, date-time — Timestamp when this contact record was last updated. - `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. - `email` string — Primary email address selected for this contact. - `personalEmail` string — Personal (non-work) email address, if available. - `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. - `company` string — Current company name of the contact. - `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. - `companyStaffCount` integer — Approximate total number of employees at the company. - `companyStaffCountRange` string — Human-readable employee count range. - `companyAnnualRevenue` string — Estimated annual revenue in USD (numeric string). - `companyDomain` string — Primary website domain of the company. - `companyRevenueRange` string — Human-readable revenue range. - `companyLIProfileUrl` string — LinkedIn company page URL. - `companyLinkedInId` string — LinkedIn numeric identifier for the company. - `title` string — Contact's current job title. - `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). - `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. - `contactLocation` object — Geographic location of the contact. - `city` string — City where the contact is located. - `state` string — Full state or province name. - `postCode` string — Postal or ZIP code. - `county` string — County name, if available. - `country` string — Full country name. - `stateAbbr` string — Two-letter state or province abbreviation. - `countryAbbr` string — Two-letter country abbreviation (ISO 3166-1 alpha-2). - `countryAlpha2` string — ISO 3166-1 alpha-2 country code. - `countryAlpha3` string — ISO 3166-1 alpha-3 country code. - `countryNumeric` integer — ISO 3166-1 numeric country code. - `fullString` string — Fully formatted location string. - `timezone` string — Timezone name with abbreviation. - `timezoneRawOffset` string — UTC offset of the timezone in hours. - `timezoneAbbr` string — Timezone abbreviation. - `companyLocation` object — Headquarters or primary office address of the contact's company. - `street1` string — Primary street address line. - `street2` string — Secondary street address line (suite, floor, etc.). - `street3` string — Tertiary street address line. - `city` string — City name. - `state` string — Full state or province name. - `postCode` string — Postal or ZIP code. - `county` string — County name, if available. - `country` string — Full country name. - `stateAbbr` string — Two-letter state or province abbreviation. - `countryAbbr` string — Two-letter country abbreviation (ISO 3166-1 alpha-2). - `countryAlpha2` string — ISO 3166-1 alpha-2 country code. - `countryAlpha3` string — ISO 3166-1 alpha-3 country code. - `countryNumeric` integer — ISO 3166-1 numeric country code. - `fullString` string — Fully formatted address string. - `website` string — Company website domain. - `emailDomain` string — Domain portion of the contact's email address, if available. - `image` string — URL to the contact's profile photo, 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. - `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. - `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 — Date the contact started at their former company (YYYY-MM-DD). - `formerEndedAt` string, date — Date the contact left their former company (YYYY-MM-DD). - `titleStartedAt` string, date — Date the contact started their current title (YYYY-MM-DD). - `startedAtCurrentCompany` string, date — Date the contact started at their current company (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"). - `jobHistory` object[] — Contact's job history. - `companyName` string — Company name for this job. - `title` string — Job title/position. - `startedAt` string, date-time — When the contact started this job. - `endedAt` string, date-time — When the contact ended this job (null for current job). - `jobChangeAlert` 'New Hire' | 'New Promotion', nullable — 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. - `companyType` 'Public' | 'Private', nullable — Company type — "Public" or "Private" when determined. - `stockTicker` string, nullable — Stock ticker symbol of the company, if publicly traded. - `apiResearchId` string — The request ID returned from the /contacts/research endpoint. Use this to correlate research requests with results. - `newsAndEvents` object[] — Recent news articles related to the company. - `title` string — The headline of the news article. - `url` string — The URL to the full news article. - `date` string, date-time — The date the news article was published. - `type` string — The type of news article (e.g., "Acquisition"). - `companyFundingTotal` string — The latest total funding amount for the company. - `companyLatestFundingDate` string, date — 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.). - `additionalData` object — Additional metadata for the poll result (e.g., error details). Free-form object. ## Other responses - `401` — Unauthorized - `422` — Insufficient credits or missing license - `500` — Unexpected error --- [API](https://skmtc.dev/seamless/apis/seamless-api.md) · [All operations](https://skmtc.dev/seamless/apis/seamless-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/seamless/seamless-api/revisions/447164d1d713/schema)