FIfiscal
Financials

Get segments and KPIs for a company

Recommended segments and KPIs endpoint. V2 returns stable numeric KPI identifiers. In v2, metricId and the metricsValues object keys use the stable KPI ID instead of the name-derived identifier returned by v1.

get/v2/company/segments-and-kpis

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/v2/company/segments-and-kpis
  • 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
periodTypestring

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

Example:annual,quarterly
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

Response

Segments and KPIs

reportingCurrencystring required
currencystring required

Example response

{
  "reportingCurrency": "USD",
  "currency": "USD",
  "metrics": [
    {
      "metricId": "7310_KPIS_37474",
      "metricName": "Total Transaction Volume",
      "metricType": "KPI",
      "metricFormat": "number",
      "isCurrency": true,
      "isImportant": true,
      "isDiscontinued": {
        "Semi-Annual": true
      }
    }
  ],
  "segmentGroups": [
    {
      "title": "Revenue by Geography",
      "metrics": [
        {
          "metricId": "7310_KPIS_37474",
          "metricName": "The Netherlands Revenue",
          "rollupMetrics": [
            {
              "metricId": "7310_KPIS_67618",
              "metricLabel": "Wafer Revenue"
            }
          ]
        }
      ]
    }
  ],
  "data": [
    {
      "periodId": "7310_Annual_2025-12-31",
      "periodType": "Annual",
      "reportDate": "2025-12-31",
      "periodDuration": "12 Months",
      "calendarYear": 2025,
      "calendarQuarter": 4,
      "fiscalYear": 2026,
      "fiscalQuarter": 1,
      "metricsValues": {
        "7310_KPIS_37474": 689253000
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 24 revisions of this API.