---
title: "Get all ratios time series for a company"
method: GET
path: "/v1/company/ratios"
tags: ["Ratios"]
---

# Get all ratios time series for a company

`GET /v1/company/ratios`

Calculates and returns all supported financial ratios for the specified company across the selected period types.

## 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.
- `ratioId` string — Return only these ratio IDs. Can be provided multiple times or as a comma-separated list.

## Response `200`

All ratios time series

- object
  - `metrics` object[], required
    - `ratioId` string, required
    - `metricName` string, required
    - `category` string, required
    - `isCurrency` boolean, required
    - `metricFormat` string, required
    - `hasDailyData` 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
    - `metricValues` object, required
      - `market_data_share_price` number, required
      - `market_data_total_shares_outstanding` number, required
      - `calculated_market_cap` number, required
      - `ratio_price_to_sales` number, required
      - `ratio_price_to_earnings` number, required
    - `tradingCurrency` object, required — Currency metadata for market cap, enterprise value, and price. Without an explicit currency parameter, these values remain in the exact listing's trading currency.
      - `currency` string, required — Currency used for market data values. Defaults to the exact listing's trading currency unless overridden by the currency parameter.
      - `originalCurrency` string, required — Currency before conversion.
      - `appliedExchangeRate` number, required — Exchange rate applied (CAD to USD) for market cap and enterprise value.
    - `reportingCurrency` object, required — Reporting currency applies to financials. If the reporting currency differs from the company's reporting currency or the currency parameter, financials will be converted to that currency.
      - `currency` string, required — Defaults to the company's reporting currency unless overridden by the currency parameter. Financials are converted to this currency.
      - `originalCurrency` string, required — Currency before conversion.
      - `appliedExchangeRate` number, required — Exchange rate applied (CAD to USD) for financials.

## Other responses

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

---

[API](https://skmtc.dev/fiscal/apis/openapi.md) · [All operations](https://skmtc.dev/fiscal/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fiscal/openapi/revisions/706968b7c65f/schema)