---
title: "Poll Company Research"
method: GET
path: "/companies/research/poll"
tags: ["Company Research"]
---

# Poll Company Research

`GET /companies/research/poll`

Get the results/status of a company research

## Query parameters

- `requestIds` string[], required

## Response `200`

Poll Results

- object
  - `success` boolean — Indicates whether the poll request executed successfully.
  - `data` object[] — Poll status entries for each requested research ID.
    - `requestId` string — Research request ID that was polled.
    - `status` 'missing' | 'researching' | 'done' | 'error' — Current state of the research request.
    - `company` object — Enriched company payload. Present when `status` is `done`.
      - `advertisingIntelligenceUrl` string — URL to advertising intelligence data for the company.
      - `alexaScoreUrl` string — URL to Alexa score and rank details.
      - `annualRevenue` string — Estimated annual revenue value.
      - `apiResearchId` string — The API research identifier for companies created through API research
      - `phones` string — Comma-separated company phone numbers.
      - `phonesAiScores` string — Comma-separated AI confidence scores for each phone number in `phones`.
      - `createdAt` string — Timestamp when this company record was created.
      - `description` string — Company profile description text.
      - `domain` string — Primary website domain of the company.
      - `employeeReviewsUrl` string — URL to employee reviews intelligence.
      - `foundedOn` string, date — Company founding date, when available.
      - `googleFinanceUrl` string — URL to Google Finance data for the company.
      - `googleResearchUrl` string — URL to Google research/profile results for the company.
      - `industries` string — Comma-separated industry labels for the company.
      - `intelUrl` string — URL to general company intelligence overview.
      - `jobPostingsUrl` string — URL to job posting intelligence for the company.
      - `linkedInProfileUrl` string — LinkedIn company profile URL.
      - `linkedInId` string — LinkedIn company identifier.
      - `localSportsTeamsUrl` string — URL to local sports context for the company location.
      - `localWeatherUrl` string — URL to local weather context for the company location.
      - `location` object
        - `street1` string — Primary street line of the company location.
        - `city` string — City of the company location.
        - `state` string — State or region of the company location.
        - `postCode` string — Postal or zip code of the company location.
        - `country` string — Country name of the company location.
        - `countryAbbr` string — Abbreviated country code used in location metadata.
        - `countryAlpha2` string — ISO 3166-1 alpha-2 country code.
        - `countryAlpha3` string — ISO 3166-1 alpha-3 country code.
        - `fullString` string — Full formatted location string.
      - `name` string — Canonical company name.
      - `newsUrl` string — URL to aggregated company news.
      - `paidSearchIntelligenceUrl` string — URL to paid search intelligence details.
      - `paidSearchKeywordsIntelligenceUrl` string — URL to paid search keyword intelligence details.
      - `revenueRange` string — Revenue range bucket for the company.
      - `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.
      - `sicCode` string — Standard Industrial Classification (SIC) code.
      - `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.
      - `staffCount` string — Estimated staff count value.
      - `staffCountRange` string — Staff count range bucket.
      - `topTechnologies` string — Comma-separated list of top detected technologies.
      - `updatedAt` string — Timestamp when this company record was last updated.
      - `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.
      - `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").
      - `fundingTotal` string — The latest total funding amount for the company.
      - `latestFundingDate` string, date — 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.).
      - `companyType` 'Public' | 'Private', nullable — Company type — "Public" or "Private" when determined.
      - `stockTicker` string, nullable — Stock ticker symbol of the company, if publicly traded.

## 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)