---
title: "Get segments and KPIs for a company"
method: GET
path: "/v1/company/segments-and-kpis"
tags: ["Financials"]
---

# Get segments and KPIs for a company

`GET /v1/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/v1/company/segments-and-kpis`
- Auth: API key in query parameter `apiKey`

Legacy v1 segments and KPIs endpoint. V1 returns name-derived metric IDs; use `/v2/company/segments-and-kpis` for new integrations because v2 returns stable numeric KPI identifiers.

## Query parameters

- `apiKey` string: API Key (alternatively send via X-Api-Key header)
- `ticker` string: Company ticker, use with mic or alone for US tickers
- `micCode` string: Company MIC, use with ticker
- `exchange` string: Company exchange code, use with ticker
- `companyKey` string: Company key (alternative to ticker/micCode/exchange)
- `cusip` string: Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP
- `isin` string: Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN
- `figi` string: FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.
- `cik` string: Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.
- `fscl` string: Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.
- `periodType` string: Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.
- `currency` string: 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.

## Response `200`

Segments and KPIs

- object
  - `reportingCurrency` string, required
  - `currency` string, required
  - `metrics` object[], required
    - `metricId` string, required
    - `metricName` string, required
    - `metricType` 'Segment' | 'KPI', required
    - `metricFormat` 'number' | '%' | 'ratio', required
    - `isCurrency` boolean, required
    - `isImportant` boolean, required
    - `isDiscontinued` object, required
      - `Annual` boolean, required
      - `Quarterly` boolean, required
      - `LTM` boolean, required
      - `Semi-Annual` boolean, required
  - `segmentGroups` object[], required
    - `title` string, required
    - `metrics` object[], required
      - `name` string, required
      - `isRollup` boolean, required
  - `data` object[], required
    - `periodId` string, required
    - `periodType` 'Annual' | 'Quarterly' | 'Semi-Annual' | 'LTM' | 'YTD', required
    - `reportDate` string, required
    - `periodDuration` string, required
    - `calendarYear` number, required
    - `calendarQuarter` number, required
    - `fiscalYear` number
    - `fiscalQuarter` number
    - `isStubPeriod` boolean: Whether this is a stub/transition period
    - `stubType` 'fye' | 'inception': Stub type: fye (fiscal year-end change) or inception (first reporting period)
    - `stubDuration` number: Actual duration of the stub period in days
    - `metricsValues` object, required

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found

---

[API](https://skmtc.dev/fiscal/apis/fiscal-api.md) - [All operations](https://skmtc.dev/fiscal/apis/fiscal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fiscal/apis/fiscal-api/revisions/85026fdfc8b8?raw)