v3

latestOpenAPI 3.1.02026-07-26490368.4 KB

Financials

Get standardized financials for a company

Returns standardized financial statements where line items are mapped to a common schema, enabling apples-to-apples comparison across companies.

get/v1/company/financials/{statementType}/standardized

Path parameters

statementType'income-statement' | 'balance-sheet' | 'cash-flow-statement' required

Financial statement category

Example:income-statement

Financial statement category

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.

periodTypestring

Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.

Example:annual,quarterly

Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.

currencystring

ISO 4217 target currency code (e.g., USD, CAD, EUR). Case-insensitive; system normalizes to uppercase. Must be 3-4 letters. Defaults to company's reporting currency.

Example:CAD

includeReportingTemplatesboolean

Include reportingTemplates metadata for each standardized metric

includeMappingAlternativesboolean

Include non-selected direct/composite as-reported audit trails without duplicating the selected asReportedValues trail

Response

Standardized financial data

reportingTemplatestring required

Example response

{
  "reportingTemplate": "Standard",
  "metrics": [
    {
      "standardizedMetricId": "income_statement_total_revenues",
      "metricName": "Total Revenues",
      "metricFormat": "number",
      "isCurrency": true,
      "headers": [
        "Revenues"
      ],
      "reportingTemplates": [
        "Standard"
      ],
      "asReportedMetrics": [
        {
          "asReportedMetricId": "1_IS_65961",
          "metricName": "Products",
          "headers": [
            "Net Sales"
          ],
          "metricFormat": "number",
          "isCurrency": true,
          "operation": "+"
        }
      ]
    }
  ],
  "data": [
    {
      "periodId": "3_Quarterly_2025-04-27",
      "periodType": "Quarterly",
      "reportDate": "2025-04-27",
      "periodDuration": "3 months",
      "calendarYear": 2025,
      "calendarQuarter": 2,
      "fiscalYear": 2026,
      "fiscalQuarter": 1,
      "stubType": "fye",
      "stubDuration": 214,
      "earningsDate": "2025-08-27",
      "earningsTimeOfDay": "16:22:14Z",
      "lastSourceFilingDate": "2025-08-27",
      "lastSourceFilingTimeOfDay": "16:22:14Z",
      "metricsValues": {
        "income_statement_total_revenues": {
          "value": 391035000000,
          "calcType": "reported",
          "mappingType": "direct",
          "unit": "M",
          "currency": "USD",
          "originalValue": 334218000000,
          "originalCurrency": "EUR",
          "appliedExchangeRate": 1.17,
          "asReportedValues": [
            {
              "asReportedMetricId": "1_IS_65961",
              "metricName": "Products",
              "headers": [
                "Net Sales"
              ],
              "operation": "+",
              "value": 294866000000,
              "unit": "M",
              "currency": "USD",
              "originalValue": 251340000000,
              "originalCurrency": "EUR",
              "appliedExchangeRate": 1.17,
              "sources": [
                {
                  "document": "https://api.fiscal.ai/v1/filing/0000320193-24-000123/pdf?ticker=AAPL&exchange=NASDAQ",
                  "image": "https://api.fiscal.ai/v1/filing/0000320193-24-000123/page/32/image?ticker=AAPL&exchange=NASDAQ",
                  "pageNumber": 32
                }
              ]
            }
          ],
          "alternativeAsReportedValues": {
            "direct": [
              {
                "asReportedMetricId": "1_IS_65961",
                "metricName": "Products",
                "headers": [
                  "Net Sales"
                ],
                "operation": "+",
                "value": 294866000000,
                "unit": "M",
                "currency": "USD",
                "originalValue": 251340000000,
                "originalCurrency": "EUR",
                "appliedExchangeRate": 1.17,
                "sources": [
                  {
                    "document": "https://api.fiscal.ai/v1/filing/0000320193-24-000123/pdf?ticker=AAPL&exchange=NASDAQ",
                    "image": "https://api.fiscal.ai/v1/filing/0000320193-24-000123/page/32/image?ticker=AAPL&exchange=NASDAQ",
                    "pageNumber": 32
                  }
                ]
              }
            ],
            "composite": [
              {
                "asReportedMetricId": "1_IS_65961",
                "metricName": "Products",
                "headers": [
                  "Net Sales"
                ],
                "operation": "+",
                "value": 294866000000,
                "unit": "M",
                "currency": "USD",
                "originalValue": 251340000000,
                "originalCurrency": "EUR",
                "appliedExchangeRate": 1.17,
                "sources": [
                  {
                    "document": "https://api.fiscal.ai/v1/filing/0000320193-24-000123/pdf?ticker=AAPL&exchange=NASDAQ",
                    "image": "https://api.fiscal.ai/v1/filing/0000320193-24-000123/page/32/image?ticker=AAPL&exchange=NASDAQ",
                    "pageNumber": 32
                  }
                ]
              }
            ]
          }
        }
      }
    }
  ]
}