v3

latestOpenAPI 3.1.02026-07-26490368.4 KB

Companies

Get a list of all companies

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.

get/v3/companies-list

Query parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

pageNumberinteger

Page number (1-indexed)

Example:1

Page number (1-indexed)

compactboolean

Return a slimmer row: fewer descriptive fields, all identifiers retained. Defaults to false (full shape). Available on every plan.

Example:true

Return a slimmer row: fewer descriptive fields, all identifiers retained. Defaults to false (full shape). Available on every plan.

allCompaniesboolean

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.

Example:true

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

A paginated array of companies with their descriptors and identifiers.

Example response

{
  "pagination": {
    "page": 1,
    "pageSize": 1000,
    "totalPages": 13,
    "totalCount": 12013,
    "hasNextPage": true
  },
  "data": [
    {
      "companyId": 2,
      "companyFiscalIdentifier": "FSCLC6CGT4DXS597",
      "companyKey": "NASDAQ_MSFT",
      "displayNameEnglish": "Microsoft Corporation",
      "legalNameEnglish": "Microsoft Corporation",
      "tradeNameEnglish": "Microsoft",
      "companyType": "operating_company",
      "companyStatus": "active",
      "headquartersCountryCode": "US",
      "headquartersCountryName": "United States",
      "headquartersRegion": "North America",
      "legalDomicileCountryCode": "US",
      "legalDomicileCountryName": "United States",
      "sector": "Information Technology",
      "industryGroup": "Software & Services",
      "industry": "Software",
      "subIndustry": "Systems Software",
      "reportingTemplate": "Standard",
      "cik": "789019",
      "marketCapUsd": 3110000000000,
      "primaryListing": {
        "ticker": "MSFT",
        "exchangeCode": "NASDAQ",
        "exchangeName": "Nasdaq Stock Market",
        "exchangeCountryCode": "US",
        "exchangeCountryName": "United States",
        "operatingMic": "XNAS",
        "segmentMic": "XNGS",
        "segmentName": "Nasdaq Global Select Market",
        "securityFiscalIdentifier": "FSCLS8TBZ3EGU251",
        "securityType": "common_stock",
        "tradingCurrency": "USD",
        "tradingStatus": "active",
        "isin": "US5949181045",
        "cusip": "594918104",
        "figi": "BBG000BPHFS9",
        "figiComposite": "BBG000BPH459",
        "figiShareClass": "BBG001S5TD05"
      },
      "reportingCurrency": "USD",
      "updatedAt": 1759766466,
      "earningsFilingDate": "2026-05-01T10:01:00Z",
      "availableDatasets": [
        "financials"
      ]
    }
  ]
}