v3

latestOpenAPI 3.1.02026-07-26490368.4 KB

Shares Outstanding

Get the latest shares outstanding for a company

Returns the total number of shares outstanding and detailed share-class breakdown as of the latest available filing for the company.

get/v1/company/shares-outstanding

Query parameters

apiKeystring

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

tickerstring

Company ticker, use with mic or alone for US tickers

Example:MSFT

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

Example:XNAS

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

Example:NASDAQ

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

Example:NASDAQ_MSFT

Company key (alternative to ticker/micCode/exchange)

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

Example:594918104

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

Example:US5949181045

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

Example:BBG000BPH459

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

Example:789019

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

fsclstring

Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.

Example:FSCLC6CGT4DXS597

Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.

Response

Shares outstanding

datestring required

ordinaryTotalSharesOutstandingnumber

Total shares in ordinary-share terms. Only present for ADR companies with a conversion factor.

Example response

[
  {
    "date": "2025-09-30",
    "totalSharesOutstanding": {
      "type": [
        "number"
      ],
      "examples": [
        2319000000
      ],
      "description": "Total shares outstanding. Null when the split-adjusted count is corrupted (< 1 share)."
    },
    "ordinaryTotalSharesOutstanding": 18552000000,
    "shareClasses": [
      {
        "shareClass": "Common Stock",
        "isMainShareClass": true,
        "sharesOutstanding": 2319000000,
        "conversionRate": 1,
        "sourceDocument": "https://api.fiscal.ai/v1/filing/0001141391-25-000090/pdf?ticker=MA&exchange=NYSE"
      }
    ]
  }
]