---
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 — Trading currency applies to market cap, enterprise value, and price. If the trading currency differs from the company's reporting currency or the currency parameter, market cap and enterprise value will be converted to that currency.
      - `currency` string, required — Defaults to the company's reporting currency unless overridden by the currency parameter. Price remains in trading currency.
      - `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/41b4b03cdc21/schema)