Fiscal.ai - API Reference

Full API reference for every Fiscal.ai endpoint — company profiles, as-reported and standardized financials, ratios, KPIs, stock prices, and filings.

Company Key:

A company key combines an exchange and ticker symbol. For US/CA exchanges, the format is exchange_ticker (e.g., NASDAQ_MSFT for Microsoft). For other exchanges, it uses MIC code: MIC_TICKER (e.g., XWAR_PKN for a Warsaw Stock Exchange listing). Use either ticker and exchange OR companyKey.

Companies List

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v2/companies-list

Get a list of all companies

Lists all companies available in the dataset together with basic descriptors and the types of data available for each company.

Parameters

apiKeystring

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

pageNumbernumber

Page number (1-indexed)

pageSizenumber

Number of items per page, max 1000

Request
$ curl "https://api.fiscal.ai/v2/companies-list"
Response
An array of companies
{
  "pagination": {
    "page": 1,
    "pageSize": 1000,
    "totalCount": 5432,
    "totalPages": 6,
    "hasNextPage": true,
    "hasPreviousPage": false
  },
  "data": [
    {
      "name": "Constellation Software Inc.",
      "ticker": "CSU",
      "exchangeName": "Toronto Stock Exchange",
      "micCode": "XTSE",
      "exchangeSymbol": "TSX",
      "countryName": "Canada",
      "countryCode": "CA",
      "tradingCurrency": "CAD",
      "reportingCurrency": "USD",
      "sector": "Information Technology",
      "industryGroup": "Software & Services",
      "industry": "Software",
      "subIndustry": "Application Software",
      "reportingTemplate": "Standard",
      "availableDatasets": "financials",
      "cik": "string",
      "cusip": "21037X100",
      "isin": "CA21037X1006"
    }
  ]
}

Company Profile

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v2/company/profile

Get profile for a single company

Retrieves a detailed company profile including sector, industry, descriptions and lists the datasets currently available under the Fiscal.ai system.

Parameters

apiKeystring

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

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

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

figistring

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

cikstring

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

Request
$ curl "https://api.fiscal.ai/v2/company/profile"
Response
Company profile
{
  "name": "Constellation Software Inc.",
  "ticker": "CSU",
  "exchangeName": "Toronto Stock Exchange",
  "micCode": "XTSE",
  "exchangeSymbol": "TSX",
  "countryName": "Canada",
  "countryCode": "CA",
  "tradingCurrency": "CAD",
  "reportingCurrency": "USD",
  "sector": "Information Technology",
  "industryGroup": "Software & Services",
  "industry": "Software",
  "subIndustry": "Application Software",
  "reportingTemplate": "Standard",
  "availableDatasets": "financials",
  "cik": "string",
  "cusip": "21037X100",
  "isin": "CA21037X1006",
  "description": "string",
  "shortDescription": "string"
}
API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v2/company/logo

Get a published company logo asset

Returns a published company logo as image bytes. Supports icon, logo (light), and logo-dark variants.

Parameters

apiKeystring

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

variantstring

Logo variant: icon (square app icon / avatar), logo (logomark for light surfaces), logo-dark (logomark for dark surfaces)

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

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

figistring

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

cikstring

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

Request
$ curl "https://api.fiscal.ai/v2/company/logo"
Response
Logo image
Example response

Financials As Reported - Income Statement

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/financials/income-statement/as-reported

Get as-reported financials for a company

Returns raw financial statement line items exactly as disclosed by the company, including source document links for traceability.

Parameters

apiKeystring

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

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

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

figistring

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

cikstring

Company CIK (SEC Central Index Key). 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'.

currencystring

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

Request
$ curl "https://api.fiscal.ai/v1/company/financials/income-statement/as-reported"
Response
As-reported financial data
{
  "metrics": [
    {
      "asReportedMetricId": "1_IS_65961",
      "metricName": "Products",
      "headers": [
        "Net Sales"
      ],
      "metricFormat": "number",
      "isPointInTime": false,
      "isCurrency": true,
      "isPerShare": false,
      "isKeyMetric": false
    }
  ],
  "data": [
    {
      "periodId": "3_Quarterly_2025-04-27",
      "periodType": "Quarterly",
      "reportDate": "2025-04-27",
      "periodDuration": "3 months",
      "calendarYear": 2025,
      "calendarQuarter": 2,
      "fiscalYear": 2026,
      "fiscalQuarter": 1,
      "metricsValues": {
        "1_IS_65961": {
          "value": 264258909200,
          "unit": "M",
          "currency": "EUR",
          "originalValue": 294866000000,
          "originalCurrency": "USD",
          "appliedExchangeRate": 0.8962,
          "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,
              "originalSourceUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm"
            }
          ]
        }
      }
    }
  ]
}

Financials As Reported - Balance Sheet

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/financials/balance-sheet/as-reported

Get as-reported financials for a company

Returns raw financial statement line items exactly as disclosed by the company, including source document links for traceability.

Parameters

apiKeystring

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

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

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

figistring

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

cikstring

Company CIK (SEC Central Index Key). 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'.

currencystring

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

Request
$ curl "https://api.fiscal.ai/v1/company/financials/balance-sheet/as-reported"
Response
As-reported financial data
{
  "metrics": [
    {
      "asReportedMetricId": "1_IS_65961",
      "metricName": "Products",
      "headers": [
        "Net Sales"
      ],
      "metricFormat": "number",
      "isPointInTime": false,
      "isCurrency": true,
      "isPerShare": false,
      "isKeyMetric": false
    }
  ],
  "data": [
    {
      "periodId": "3_Quarterly_2025-04-27",
      "periodType": "Quarterly",
      "reportDate": "2025-04-27",
      "periodDuration": "3 months",
      "calendarYear": 2025,
      "calendarQuarter": 2,
      "fiscalYear": 2026,
      "fiscalQuarter": 1,
      "metricsValues": {
        "1_IS_65961": {
          "value": 264258909200,
          "unit": "M",
          "currency": "EUR",
          "originalValue": 294866000000,
          "originalCurrency": "USD",
          "appliedExchangeRate": 0.8962,
          "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,
              "originalSourceUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm"
            }
          ]
        }
      }
    }
  ]
}

Financials As Reported - Cash Flow Statement

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/financials/cash-flow-statement/as-reported

Get as-reported financials for a company

Returns raw financial statement line items exactly as disclosed by the company, including source document links for traceability.

Parameters

apiKeystring

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

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

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

figistring

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

cikstring

Company CIK (SEC Central Index Key). 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'.

currencystring

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

Request
$ curl "https://api.fiscal.ai/v1/company/financials/cash-flow-statement/as-reported"
Response
As-reported financial data
{
  "metrics": [
    {
      "asReportedMetricId": "1_IS_65961",
      "metricName": "Products",
      "headers": [
        "Net Sales"
      ],
      "metricFormat": "number",
      "isPointInTime": false,
      "isCurrency": true,
      "isPerShare": false,
      "isKeyMetric": false
    }
  ],
  "data": [
    {
      "periodId": "3_Quarterly_2025-04-27",
      "periodType": "Quarterly",
      "reportDate": "2025-04-27",
      "periodDuration": "3 months",
      "calendarYear": 2025,
      "calendarQuarter": 2,
      "fiscalYear": 2026,
      "fiscalQuarter": 1,
      "metricsValues": {
        "1_IS_65961": {
          "value": 264258909200,
          "unit": "M",
          "currency": "EUR",
          "originalValue": 294866000000,
          "originalCurrency": "USD",
          "appliedExchangeRate": 0.8962,
          "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,
              "originalSourceUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm"
            }
          ]
        }
      }
    }
  ]
}

Financials Standardized - Income Statement

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/financials/income-statement/standardized

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.

Parameters

apiKeystring

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

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

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

figistring

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

cikstring

Company CIK (SEC Central Index Key). 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'.

currencystring

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

Request
$ curl "https://api.fiscal.ai/v1/company/financials/income-statement/standardized"
Response
Standardized financial data
{
  "reportingTemplate": "Standard",
  "metrics": [
    {
      "standardizedMetricId": "income_statement_total_revenues",
      "metricName": "Total Revenues",
      "metricFormat": "number",
      "isPointInTime": false,
      "isCurrency": true,
      "isTotal": false,
      "headers": [
        "Revenues"
      ],
      "asReportedMetrics": [
        {
          "asReportedMetricId": "1_IS_65961",
          "metricName": "Products",
          "headers": [
            "Net Sales"
          ],
          "metricFormat": "number",
          "isPointInTime": false,
          "isCurrency": true,
          "isPerShare": false,
          "isKeyMetric": false,
          "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,
      "metricsValues": {
        "income_statement_total_revenues": {
          "value": 391035000000,
          "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
                }
              ]
            }
          ]
        }
      }
    }
  ]
}

Financials Standardized - Balance Sheet

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/financials/balance-sheet/standardized

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.

Parameters

apiKeystring

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

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

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

figistring

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

cikstring

Company CIK (SEC Central Index Key). 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'.

currencystring

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

Request
$ curl "https://api.fiscal.ai/v1/company/financials/balance-sheet/standardized"
Response
Standardized financial data
{
  "reportingTemplate": "Standard",
  "metrics": [
    {
      "standardizedMetricId": "income_statement_total_revenues",
      "metricName": "Total Revenues",
      "metricFormat": "number",
      "isPointInTime": false,
      "isCurrency": true,
      "isTotal": false,
      "headers": [
        "Revenues"
      ],
      "asReportedMetrics": [
        {
          "asReportedMetricId": "1_IS_65961",
          "metricName": "Products",
          "headers": [
            "Net Sales"
          ],
          "metricFormat": "number",
          "isPointInTime": false,
          "isCurrency": true,
          "isPerShare": false,
          "isKeyMetric": false,
          "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,
      "metricsValues": {
        "income_statement_total_revenues": {
          "value": 391035000000,
          "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
                }
              ]
            }
          ]
        }
      }
    }
  ]
}

Financials Standardized - Cash Flow Statement

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/financials/cash-flow-statement/standardized

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.

Parameters

apiKeystring

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

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

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

figistring

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

cikstring

Company CIK (SEC Central Index Key). 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'.

currencystring

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

Request
$ curl "https://api.fiscal.ai/v1/company/financials/cash-flow-statement/standardized"
Response
Standardized financial data
{
  "reportingTemplate": "Standard",
  "metrics": [
    {
      "standardizedMetricId": "income_statement_total_revenues",
      "metricName": "Total Revenues",
      "metricFormat": "number",
      "isPointInTime": false,
      "isCurrency": true,
      "isTotal": false,
      "headers": [
        "Revenues"
      ],
      "asReportedMetrics": [
        {
          "asReportedMetricId": "1_IS_65961",
          "metricName": "Products",
          "headers": [
            "Net Sales"
          ],
          "metricFormat": "number",
          "isPointInTime": false,
          "isCurrency": true,
          "isPerShare": false,
          "isKeyMetric": false,
          "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,
      "metricsValues": {
        "income_statement_total_revenues": {
          "value": 391035000000,
          "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
                }
              ]
            }
          ]
        }
      }
    }
  ]
}

Standardized Metrics List

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/standardized-metrics-list/{templateType}/{statementType}

Get the list of all standardized metrics.

Returns the list of all standardized metrics.

Parameters

templateTypestringpathrequired

Reporting template category

statementTypestringpathrequired

Financial statement category

apiKeystring

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

Request
$ curl "https://api.fiscal.ai/v1/standardized-metrics-list/{templateType}/{statementType}"
Response
Standardized metrics list
{
  "reportingTemplate": "Standard",
  "metrics": [
    {
      "standardizedMetricId": "income_statement_total_revenues",
      "metricName": "Total Revenues",
      "metricFormat": "number",
      "isPointInTime": false,
      "isCurrency": true,
      "isTotal": false,
      "headers": [
        "Income"
      ]
    }
  ]
}

All Standardized Metrics

Loading API specification...

Company Ratios

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/ratios

Get all ratios time series for a company

Calculates and returns all supported financial ratios for the specified company across the selected period types. Where applicable, calculated intermediate metrics are omitted from the response unless diagnostics are requested.

Parameters

apiKeystring

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

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

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

figistring

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

cikstring

Company CIK (SEC Central Index Key). 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'.

currencystring

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

include_diagnosticsboolean

Include diagnostics in the response

ratioIdstring

Return only these ratio IDs. Can be provided multiple times or as a comma-separated list.

Request
$ curl "https://api.fiscal.ai/v1/company/ratios"
Response
All ratios time series
{
  "metrics": [
    {
      "ratioId": "price_to_earnings",
      "metricName": "Price to Earnings",
      "category": "Valuation",
      "isCurrency": false,
      "metricFormat": "ratio",
      "hasDailyData": true
    }
  ],
  "data": [
    {
      "periodId": "3_Quarterly_2025-04-27",
      "periodType": "Quarterly",
      "reportDate": "2025-04-27",
      "periodDuration": "3 months",
      "calendarYear": 2025,
      "calendarQuarter": 2,
      "fiscalYear": 2026,
      "fiscalQuarter": 1,
      "metricValues": {
        "market_data_share_price": 108.73,
        "market_data_total_shares_outstanding": 24388000000,
        "calculated_market_cap": 2651707240000,
        "ratio_price_to_sales": 60.18,
        "ratio_price_to_earnings": 143.07
      },
      "currency": "USD",
      "originalCurrency": "EUR",
      "appliedExchangeRate": 1.17
    }
  ]
}

Daily Ratios

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/ratios/daily/{ratioId}

Get daily ratio time-series for a company

Returns a daily time-series for the specified ratio. The ratio is recomputed for each trading day using the closing share price for that day and the most recently reported fundamental inputs (e.g. EPS, shares outstanding) available as of that date.

Parameters

ratioIdstringpathrequired

ID of the ratio (e.g. ratio_price_to_earnings)

apiKeystring

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

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

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

figistring

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

cikstring

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

currencystring

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

Request
$ curl "https://api.fiscal.ai/v1/company/ratios/daily/{ratioId}"
Response
Daily ratio series
[
  {
    "date": "2025-07-10",
    "ratio": 25.34
  }
]

Ratios List

Full List of Ratios:

For a full list of ratios, see our Ratios Reference.

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/ratios-list

Get the list of all ratios.

Returns the list of all ratios.

Parameters

apiKeystring

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

Request
$ curl "https://api.fiscal.ai/v1/ratios-list"
Response
Ratios list
[
  {
    "ratioId": "price_to_earnings",
    "metricName": "Price to Earnings",
    "category": "Valuation",
    "isCurrency": false,
    "metricFormat": "ratio",
    "hasDailyData": true,
    "formulaHuman": "Market Price per Share / Earnings per Share"
  }
]

Shares Outstanding

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/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.

Parameters

apiKeystring

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

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

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

figistring

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

cikstring

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

Request
$ curl "https://api.fiscal.ai/v1/company/shares-outstanding"
Response
Shares outstanding
[
  {
    "date": "2025-04-28",
    "totalSharesOutstanding": 908047623,
    "shareClasses": [
      {
        "shareClass": "Class A",
        "isMainShareClass": true,
        "sharesOutstanding": 901263158,
        "conversionRate": 1,
        "sourceDocument": "https://api.fiscal.ai/v1/filing/0001141391-25-000090/pdf?ticker=MA&exchange=NYSE"
      }
    ]
  }
]

Adjusted Metrics

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/adjusted-metrics

Get the latest adjusted metrics for a company

Returns the adjusted metrics for a company.

Parameters

apiKeystring

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

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

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

figistring

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

cikstring

Company CIK (SEC Central Index Key). 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'.

currencystring

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

Request
$ curl "https://api.fiscal.ai/v1/company/adjusted-metrics"
Response
Adjusted metrics
{
  "metrics": [
    {
      "metricId": "adjusted_revenue",
      "metricName": "Adjusted Revenue",
      "metricFormat": "number",
      "isCurrency": true,
      "isPerShare": false,
      "isKeyMetric": false
    }
  ],
  "data": [
    {
      "periodId": "3_Quarterly_2025-04-27",
      "periodType": "Quarterly",
      "reportDate": "2025-04-27",
      "periodDuration": "3 months",
      "calendarYear": 2025,
      "calendarQuarter": 2,
      "fiscalYear": 2026,
      "fiscalQuarter": 1,
      "lastSourceFilingDate": "2025-08-27",
      "lastSourceFilingTimeOfDay": "16:22:14",
      "metricValues": {
        "value": 264258909200,
        "unit": "M",
        "currency": "EUR",
        "adjusted": true,
        "originalValue": 294866000000,
        "originalCurrency": "USD",
        "appliedExchangeRate": 0.8962,
        "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,
            "originalSourceUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm"
          }
        ]
      }
    }
  ]
}

Segments and KPIs

Loading API specification...

Earnings Calendar

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/calendar/earnings

Get earnings calendar events

Returns earnings calendar data powered by Benzinga, including scheduled earnings dates, EPS and revenue estimates, reported actuals, and surprise metrics. Filter by tickers, date range, or importance level.

Parameters

apiKeystring

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

tickersstring

Comma-separated company keys (EXCHANGE_TICKER format, e.g. NASDAQ_AAPL,NYSE_MSFT) or plain ticker symbols (AAPL,MSFT). Max 50.

datestring

Single date to query (YYYY-MM-DD). Shorthand for dateFrom and dateTo when both are the same.

dateFromstring

Start date for date range filter (YYYY-MM-DD)

dateTostring

End date for date range filter (YYYY-MM-DD)

importanceinteger

Minimum importance level to filter by (0-5). Returns events with importance greater than or equal to this value.

pageinteger

Page offset for pagination (0-100000)

pageSizeinteger

Number of results per page

dateSortstring

Sort by date. Use date:asc or date:desc

updatedinteger

Only return records updated after this Unix timestamp (UTC)

isinstring

ISIN to look up. Resolves to ticker via our database, then queries Benzinga. Requires CUSIP/ISIN license.

cusipstring

CUSIP to look up. Resolves to ticker via our database, then queries Benzinga. Requires CUSIP/ISIN license.

Request
$ curl "https://api.fiscal.ai/v1/calendar/earnings"
Response
Earnings calendar events
[
  {
    "id": "123456",
    "date": "2026-03-15",
    "dateConfirmed": "1",
    "time": "16:30:00",
    "ticker": "AAPL",
    "exchange": "NASDAQ",
    "name": "Apple Inc",
    "isin": "US0378331005",
    "cusip": "037833100",
    "currency": "USD",
    "period": "Q1",
    "periodYear": 2026,
    "epsType": "Diluted",
    "eps": 1.52,
    "epsEst": 1.48,
    "epsPrior": 1.4,
    "epsSurprise": 0.04,
    "epsSurprisePercent": 2.7,
    "revenueType": "Total Revenue",
    "revenue": 94836000000,
    "revenueEst": 93890000000,
    "revenuePrior": 89498000000,
    "revenueSurprise": 946000000,
    "revenueSurprisePercent": 1.01,
    "importance": 5,
    "notes": "string",
    "updated": 1711900800
  }
]

Stock Splits

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/stock-splits

Get the stock splits for a company

Provides all historical stock split and stock dividend events for the requested company, including split ratio and relevant dates.

Parameters

apiKeystring

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

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

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

figistring

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

cikstring

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

Request
$ curl "https://api.fiscal.ai/v1/company/stock-splits"
Response
Stock splits
[
  {
    "announceDate": "2023-01-15",
    "recordDate": "2023-02-01",
    "exDate": "2023-02-05",
    "payDate": "2023-02-10",
    "splitType": "Stock Split",
    "rate": 2
  }
]

Stock Prices

Loading API specification...

Company Filings (v2)

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v2/company/filings

Get filings for a company

Retrieves a list of filings for the specified company from the last 20 years. Currently supports: - Annual Report - Interim Report - Earnings Press Release - Current Report - Initial Registration Statement The fiscal year, quarter, and report date are only available if there was financial data extracted from the filing.

Parameters

apiKeystring

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

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

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

figistring

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

cikstring

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

Request
$ curl "https://api.fiscal.ai/v2/company/filings"
Response
An array of filings
[
  {
    "filingId": "0000002208-25-4901693",
    "documentType": "Earnings Press Release",
    "filingDate": "2025-02-26",
    "reportDate": "2024-12-31",
    "fiscalYear": 2024,
    "fiscalQuarter": 4,
    "pdfUrl": "https://api.fiscal.ai/v1/filing/0000002208-25-4901693/pdf?companyKey=TSX_TOI",
    "sourceUrl": "https://www.sedarplus.ca/csa-party/records/document.html?id=34628a35c29576e2221ea35daaba7999b10cd4c4604b19f72b3c4620508ca224"
  }
]

Filing Image (by page)

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/filing/{filingId}/page/{pageNumber}/image

Get an image of a filing page

Fetches a high-resolution JPEG image of the specified page from the original SEC filing document. Suitable for embedding in client applications for source traceability.

Parameters

filingIdstringpathrequired

Filing ID

pageNumbernumberpathrequired

Page number

apiKeystring

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

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

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

figistring

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

cikstring

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

Request
$ curl "https://api.fiscal.ai/v1/filing/{filingId}/page/{pageNumber}/image"
Response
Page image
<binary image/jpeg>

Filing PDF

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/filing/{filingId}/pdf

Get the full PDF of a filing

Downloads the complete PDF version of the SEC filing referenced by its accession number.

Parameters

filingIdstringpathrequired

Filing ID

apiKeystring

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

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

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

figistring

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

cikstring

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

Request
$ curl "https://api.fiscal.ai/v1/filing/{filingId}/pdf"
Response
Filing PDF
<binary application/pdf>

Companies List (v1)

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/companies-list

[DEPRECATED] Get a list of all companies (use /v2/companies-list instead)

Lists all companies available in the dataset together with basic descriptors and the types of data available for each company. This endpoint is deprecated, please use /v2/companies-list instead.

Parameters

apiKeystring

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

Request
$ curl "https://api.fiscal.ai/v1/companies-list"
Response
An array of companies
[
  {
    "name": "Visa Inc.",
    "ticker": "V",
    "cik": "1403161",
    "exchangeName": "New York Stock Exchange",
    "exchangeSymbol": "NYSE",
    "country": "United States",
    "countryCode": "US",
    "sector": "Financials",
    "industryGroup": "Financial Services",
    "industry": "Financial Services",
    "subIndustry": "Transaction & Payment Processing Services",
    "reportingTemplate": "Standard",
    "dataAvailable": [
      "financials"
    ],
    "cusip": [
      "92826C839"
    ],
    "isin": [
      "US92826C8394"
    ]
  }
]

Company Profile (v1)

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/profile

[DEPRECATED] Get profile for a single company (use /v2/company/profile instead)

Retrieves a detailed company profile including sector, industry, descriptions and lists the datasets currently available under the Fiscal.ai system. This endpoint is deprecated, please use /v2/company/profile instead.

Parameters

apiKeystring

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

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

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

figistring

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

cikstring

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

Request
$ curl "https://api.fiscal.ai/v1/company/profile"
Response
Company profile
{
  "name": "Visa Inc.",
  "ticker": "V",
  "cik": "1403161",
  "exchangeName": "New York Stock Exchange",
  "exchangeSymbol": "NYSE",
  "countryName": "United States",
  "countryCode": "US",
  "sector": "Financials",
  "industryGroup": "Financial Services",
  "industry": "Financial Services",
  "subIndustry": "Transaction & Payment Processing Services",
  "reportingTemplate": "Standard",
  "reportingCurrency": "USD",
  "tradingCurrency": "USD",
  "dataAvailable": [
    "financials"
  ],
  "description": "Visa Inc. is a global payments technology company that facilitates electronic fund transfers among consumers, merchants, financial institutions, and governments in over 200 countries and territories...",
  "shortDescription": "Visa Inc. is a global payments technology company based in Foster City, California, that processes electronic transactions in over 200 countries...",
  "cusip": [
    "92826C839"
  ],
  "isin": [
    "US92826C8394"
  ]
}

Company Filings (v1)

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/filings

[DEPRECATED] Get filings for a company (use /v2/company/filings instead)

Retrieves a list of filings for the specified company from the last 20 years. This endpoint is deprecated, please use /v2/company/filings instead.

Parameters

apiKeystring

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

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

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

figistring

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

cikstring

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

Request
$ curl "https://api.fiscal.ai/v1/company/filings"
Response
A list of filings
[
  {
    "filing_id": "0000950170-25-100235",
    "document_type": "Annual Report",
    "filing_date": "2025-08-01",
    "report_date": "2025-06-28",
    "pdf_url": "https://api.fiscal.ai/v1/filing/0000950170-25-100235/pdf?ticker=MSFT&exchange=NASDAQ"
  }
]

Stock Prices (v1)

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/stock-prices

Get the stock prices for a company

Returns the daily closing share price series for the specified company. Prices are split-adjusted and expressed in the company reporting currency where applicable. Currently, only primary listings are supported.

Parameters

apiKeystring

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

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

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

figistring

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

cikstring

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

Request
$ curl "https://api.fiscal.ai/v1/company/stock-prices"
Response
Stock prices
[
  {
    "date": "2025-07-10",
    "price": 195.38
  }
]