---
title: "Get a list of all companies"
method: GET
path: "/v3/companies-list"
tags: ["Companies"]
---

# Get a list of all companies

`GET /v3/companies-list`

Lists companies along with their descriptors — display and legal names, sector and industry classification, headquarters and legal domicile, the embedded `primaryListing`, market cap, key identifiers (company & security fiscal identifiers, CIK, and licensed CUSIP/ISIN/FIGI), reporting template, and the datasets available for each company. By default only companies with API-enabled data are returned; pass `allCompanies=true` for the full universe. Results are server-paginated (`pagination.totalCount` reflects the selected set); `updatedAt` and `earningsFilingDate` are always served live. Pass `compact=true` for a reduced payload. Free-plan keys receive only the free-plan companies (a single page), in either shape.

## Query parameters

- `apiKey` string — API Key (alternatively send via X-Api-Key header)
- `pageNumber` integer — Page number (1-indexed)
- `compact` boolean — Return a slimmer row: fewer descriptive fields, all identifiers retained. Defaults to false (full shape). Available on every plan.
- `allCompanies` boolean — Set true to include the full ~55,000-company universe. Defaults to false — only companies with API-enabled data. Not available on the free plan.

## Response `200`

A paginated array of companies with their descriptors and identifiers.

- object
  - `pagination` object, required
    - `page` number, required
    - `pageSize` number, required
    - `totalPages` number, required
    - `totalCount` number, required — Total companies in the selected set.
    - `hasNextPage` boolean, required
    - `hasPreviousPage` boolean, required
  - `data` object[], required
    - `companyId` integer, required — Not recommended, please use companyFiscalIdentifier instead.
    - `companyFiscalIdentifier` string — Fiscal.ai stable company identifier.
    - `companyKey` string, required — Fiscal.ai company key (exchangeCode_ticker).
    - `displayNameEnglish` string — Common display name.
    - `legalNameEnglish` string
    - `tradeNameEnglish` string
    - `legalNameNative` string — Legal name in the company's native language/script.
    - `tradeNameNative` string
    - `companyType` 'operating_company' | 'investment_company' | 'reit' | 'spac' | 'government' — Company type
    - `companyStatus` 'active' | 'defunct' | 'dormant' | 'reorganizing' | 'shell' — Company lifecycle status
    - `headquartersCountryCode` string — Headquarters country (ISO 3166-1 alpha-2)
    - `headquartersCountryName` string — Headquarters country
    - `headquartersRegion` string
    - `legalDomicileCountryCode` string — Legal domicile country (ISO 3166-1 alpha-2)
    - `legalDomicileCountryName` string
    - `sector` 'Communication Services' | 'Consumer Discretionary' | 'Consumer Staples' | 'Energy' | 'Financials' | 'Health Care' | 'Industrials' | 'Information Technology' | 'Materials' | 'Real Estate' | 'Utilities' — GICS sector
    - `industryGroup` string — GICS industry group
    - `industry` string — GICS industry
    - `subIndustry` string — GICS sub-industry
    - `reportingTemplate` 'Standard' | 'Financials' | 'Capital Markets' | 'Insurance' | 'Real Estate' | 'Utilities' — Reporting template assigned by GICS sub-industry
    - `cik` string — SEC Central Index Key (the company's current CIK — the latest in its CIK history)
    - `marketCapUsd` number — Latest market capitalization in USD.
    - `primaryListing` object, required
      - `listingFiscalIdentifier` string — Fiscal.ai stable listing identifier.
      - `ticker` string
      - `exchangeCode` string — Listing exchange code
      - `exchangeName` string
      - `exchangeCountryCode` string
      - `exchangeCountryName` string
      - `operatingMic` string — Operating MIC of the listing exchange
      - `segmentMic` string — Segment MIC of the listing exchange
      - `segmentName` string
      - `securityFiscalIdentifier` string — Fiscal.ai stable security identifier.
      - `securityType` 'common_stock' | 'preferred_stock' | 'depositary_receipt' | 'unit' — Security type
      - `tradingCurrency` string
      - `tradingStatus` 'active' | 'delisted' | 'pre_ipo' | 'suspended' — Trading status of this listing
      - `isin` string — Only returned with a CUSIP/ISIN license.
      - `cusip` string — Only returned with a CUSIP/ISIN license.
      - `figi` string — Venue-level FIGI of this exchange line.
      - `figiComposite` string — Country-level composite FIGI of the security (the FIGI most databases store).
      - `figiShareClass` string — Global share-class FIGI of the security.
    - `reportingCurrency` string — Company reporting currency (ISO 4217)
    - `updatedAt` integer — Company's last data change (Unix seconds). Injected live, never cached.
    - `earningsFilingDate` string — Latest earnings filing date (YYYY-MM-DDTHH:mm:ss[Z]). Injected live.
    - `availableDatasets` string[], required

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/fiscal/apis/openapi.md) · [All operations](https://skmtc.net/fiscal/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fiscal/openapi/versions/5e2c5deea9a5/schema)