---
title: "Company overview"
method: GET
path: "/v1/companies/overview"
---

# Company overview

`GET /v1/companies/overview`

## Request

- Base URL: `https://api.turos.app`
- URL: `https://api.turos.app/v1/companies/overview`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Use this route to start issuer research with identity, classification, the latest material filing, and a financial snapshot drawn from recent annual SEC XBRL facts. `companyType` determines which metrics are meaningful, so null margins or cash-flow values can be expected for financial institutions or pre-revenue companies. Optional enrichments are bounded and independently statused; factor exposure is descriptive, not a forecast, and footnotes are returned as a reference. Preserve the returned filing, provenance, and freshness fields before presenting the snapshot as current. See [statements reference](/api-reference/statements) and [freshness and source evidence](/freshness-and-trust).

## Query parameters

- `ticker` string
- `symbol` string
- `cik` string
- `tickers` string
- `symbols` string
- `include` string

## Response `200`

Successful response

- union
  - CompanyOverview
    - `object` 'company_overview', required
    - `id` string, required
    - `createdAt` string, required
    - `livemode` boolean, required
    - `identity` object, required
      - `entityId` string, required
      - `cik` string, required
      - `ticker` string, nullable, required
      - `name` string, required
      - `tickers` string[], required
      - `aliases` string[], required
      - `entityType` string, required
      - `sector` string, nullable, required
      - `industry` string, nullable, required
      - `sicCode` string, nullable, required
      - `sicDescription` string, nullable, required
      - `stateOfIncorporation` string, nullable, required
      - `fiscalYearEnd` string, nullable, required
      - `exchange` string, nullable, required
      - `exchanges` string[], required
      - `formerNames` object[], required
        - `name` string, required
        - `from` string, nullable, required
        - `to` string, nullable, required
    - `latestMaterialFiling` object, nullable, required
      - `object` 'company_overview_latest_filing', required
      - `form` string, required
      - `filingDate` string, required
      - `accessionNumber` string, required
      - `title` string, nullable, required
      - `filingUrl` string, nullable, required
    - `financialSnapshot` object, required
      - `companyType` 'operating' | 'financial_institution' | 'pre_revenue', required
      - `fiscalYears` number[], required
      - `revenueConcept` object, nullable, required
        - `taxonomy` string, required
        - `tag` string, required
      - `metrics` object, required
        - `revenue` object, required
          - `value` number, nullable, required
          - `series` number[], required
          - `yoyGrowthPct` number, nullable, required
          - `cagr3yPct` number, nullable, required
        - `netIncome` object, required
          - `value` number, nullable, required
          - `series` number[], required
          - `yoyGrowthPct` number, nullable, required
        - `dilutedEps` object, required
          - `value` number, nullable, required
          - `series` number[], required
          - `yoyGrowthPct` number, nullable, required
        - `margins` object, required
          - `gross` number, nullable, required
          - `operating` number, nullable, required
          - `net` number, nullable, required
        - `roePct` number, nullable, required
        - `roaPct` number, nullable, required
        - `balanceSheet` object, required
          - `assets` number, nullable, required
          - `equity` number, nullable, required
          - `cash` number, nullable, required
          - `longTermDebt` number, nullable, required
          - `debtToEquity` number, nullable, required
          - `bookValue` number, nullable, required
        - `freeCashFlow` number, nullable, required
        - `fcfMargin` number, nullable, required
      - `provenance` object, nullable
        - `source` string, required
        - `sourceLabel` string
        - `sourceAgency` string
        - `canonicality` string
        - `fallbackPolicy` string
        - `accessionNumber` string, nullable, required
        - `filingUrl` string, uri, required
        - `acceptedAt` string, nullable
        - `retrievedAt` string, required
        - `parserVersion` string, required
      - `freshness` object
        - `status` 'fresh' | 'current' | 'archival' | 'stale' | 'degraded' | 'unknown', required
        - `asOf` string, required
        - `sourcePublishedAt` string, nullable
        - `lagMs` integer, nullable
        - `synthetic` boolean
      - `materialization` object
        - `parserVersion` string, required
        - `materializationVersion` string, required
    - `enrichments` object, required
      - `segments` object, required
        - `status` 'included' | 'reference' | 'error' | 'not_requested', required
        - `reference` object, nullable
          - `endpoint` string, required
          - `method` string, required
          - `query` object, nullable
          - `body` object, nullable
        - `data` unknown
        - `error` object, nullable
          - `code` string, required
          - `message` string, required
      - `footnotes` object, required
        - `status` 'included' | 'reference' | 'error' | 'not_requested', required
        - `reference` object, nullable
          - `endpoint` string, required
          - `method` string, required
          - `query` object, nullable
          - `body` object, nullable
        - `data` unknown
        - `error` object, nullable
          - `code` string, required
          - `message` string, required
      - `dilution` object, required
        - `status` 'included' | 'reference' | 'error' | 'not_requested', required
        - `reference` object, nullable
          - `endpoint` string, required
          - `method` string, required
          - `query` object, nullable
          - `body` object, nullable
        - `data` unknown
        - `error` object, nullable
          - `code` string, required
          - `message` string, required
      - `factors` object, required
        - `status` 'included' | 'reference' | 'error' | 'not_requested', required
        - `reference` object, nullable
          - `endpoint` string, required
          - `method` string, required
          - `query` object, nullable
          - `body` object, nullable
        - `data` unknown
        - `error` object, nullable
          - `code` string, required
          - `message` string, required
    - `links` object
      - `fundLetters` string
    - `provenance` object, nullable
      - `source` string, required
      - `sourceLabel` string
      - `sourceAgency` string
      - `canonicality` string
      - `fallbackPolicy` string
      - `accessionNumber` string, nullable, required
      - `filingUrl` string, uri, required
      - `acceptedAt` string, nullable
      - `retrievedAt` string, required
      - `parserVersion` string, required
    - `freshness` object
      - `status` 'fresh' | 'current' | 'archival' | 'stale' | 'degraded' | 'unknown', required
      - `asOf` string, required
      - `sourcePublishedAt` string, nullable
      - `lagMs` integer, nullable
      - `synthetic` boolean
  - CompanyOverviewBatch
    - `object` 'list', required
    - `data` union[], required
      - union
        - object
          - `object` 'company_overview', required
          - `id` string, required
          - `createdAt` string, required
          - `livemode` boolean, required
          - `identity` object, required
            - `entityId` string, required
            - `cik` string, required
            - `ticker` string, nullable, required
            - `name` string, required
            - `tickers` string[], required
            - `aliases` string[], required
            - `entityType` string, required
            - `sector` string, nullable, required
            - `industry` string, nullable, required
            - `sicCode` string, nullable, required
            - `sicDescription` string, nullable, required
            - `stateOfIncorporation` string, nullable, required
            - `fiscalYearEnd` string, nullable, required
            - `exchange` string, nullable, required
            - `exchanges` string[], required
            - `formerNames` object[], required
              - …
          - `latestMaterialFiling` object, nullable, required
            - `object` 'company_overview_latest_filing', required
            - `form` string, required
            - `filingDate` string, required
            - `accessionNumber` string, required
            - `title` string, nullable, required
            - `filingUrl` string, nullable, required
          - `financialSnapshot` object, required
            - `companyType` 'operating' | 'financial_institution' | 'pre_revenue', required
            - `fiscalYears` number[], required
            - `revenueConcept` object, nullable, required
              - …
            - `metrics` object, required
              - …
            - `provenance` object, nullable
              - …
            - `freshness` object
              - …
            - `materialization` object
              - …
          - `enrichments` object, required
            - `segments` object, required
              - …
            - `footnotes` object, required
              - …
            - `dilution` object, required
              - …
            - `factors` object, required
              - …
          - `links` object
            - `fundLetters` string
          - `provenance` object, nullable
            - `source` string, required
            - `sourceLabel` string
            - `sourceAgency` string
            - `canonicality` string
            - `fallbackPolicy` string
            - `accessionNumber` string, nullable, required
            - `filingUrl` string, uri, required
            - `acceptedAt` string, nullable
            - `retrievedAt` string, required
            - `parserVersion` string, required
          - `freshness` object
            - `status` 'fresh' | 'current' | 'archival' | 'stale' | 'degraded' | 'unknown', required
            - `asOf` string, required
            - `sourcePublishedAt` string, nullable
            - `lagMs` integer, nullable
            - `synthetic` boolean
          - `ticker` string, required
          - `status` 'ok', required
        - object
          - `ticker` string, required
          - `status` 'error', required
          - `error` object, required
            - `code` string, required
            - `message` string, required
    - `count` integer, required
    - `degradedState` object, nullable, required
      - `status` 'partial', required
      - `reason` string, required
      - `missingTickers` string[], required
    - `requestId` string
    - `traceparent` string

## Other responses

- `default`: Contract-aware error response

---

[API](https://skmtc.dev/turos/apis/turos-api.md) · [All operations](https://skmtc.dev/turos/apis/turos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/turos/apis/turos-api/revisions/a68d3ec80a56?raw)