Shares Outstanding

Get the latest shares outstanding for a company

Changed on Sep 30, 2026

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

Request

Base URL
https://api.fiscal.ai (the document declares no server; this is the origin it was published from)
URL
https://api.fiscal.ai/v1/company/shares-outstanding
Auth
API key in query parameter apiKey

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

micCodestring

Company MIC, use with ticker

Example:XNAS

exchangestring

Company exchange code, use with ticker

Example:NASDAQ

companyKeystring

Company key (alternative to ticker/micCode/exchange)

Example:NASDAQ_MSFT

cusipstring

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

Example:594918104

isinstring

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

Example:US5949181045

figistring

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

Example:BBG000BPH459

cikstring

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

Example:789019

fsclstring

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

Example:FSCLC6CGT4DXS597

Response

Shares outstanding

datestring required

totalSharesOutstandingnumber nullable required

Total shares outstanding. Null when the split-adjusted count is corrupted (< 1 share).

ordinaryTotalSharesOutstandingnumber nullable

Total shares in ordinary-share terms. Present for a company with a depositary programme when a conversion factor is known (the ADS total converted), and for a company served on the ordinary basis (equal to totalSharesOutstanding; null on a record whose served total is not known to be in ordinary shares, such as a count in depositary units that no ratio could restate or a total the serving filters replaced with a depositary-unit figure, and on a reverse-split-corrupted record); absent for a company that never had a programme.

Example response

[
  {
    "date": "2025-09-30",
    "totalSharesOutstanding": 2319000000,
    "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"
      }
    ]
  }
]

Changes

Sep 30, 20263ad28282d83c Revision changes
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the / response's property type changed from object to number null for status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
Jul 26, 20265e2c5deea9a5 Revision changes
- breaking
  the / response's property type changed from number to object for status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status

Operation history