---
title: "Get KPI metrics"
method: GET
path: "/kpi/metrics"
tags: ["KPIs"]
---

# Get KPI metrics

`GET /kpi/metrics`

Get sector-specific operational KPIs for a ticker. Includes metrics like load factor, CET1 ratio, same-store sales, FFO per share, and more. Sourced from SEC 8-K earnings releases.

## Query parameters

- `ticker` string, required
- `metric_name` string
- `period` 'quarterly' | 'annual'
- `report_period_gte` string, date
- `report_period_lte` string, date
- `limit` integer

## Response `200`

KPI metrics response

- KPIMetricsResponse
  - `kpi_metrics` KPIMetric[]
    - `ticker` string, required — Stock ticker symbol.
    - `metric_name` string, required — Canonical metric name.
    - `value` number, nullable, required — Extracted numeric value.
    - `unit` string, required — Unit of measure (e.g., %, cents, dollars, miles, count).
    - `period` string, required — Reporting period (e.g., Q4 2025, FY 2025, or a date like 2025-04-30 for non-standard fiscal years).
    - `period_type` 'quarterly' | 'annual', required — Whether this is a quarterly or annual figure.
    - `segment` string, nullable — Business segment, geography, or sub-category. Only present when the metric is reported for a sub-unit rather than the consolidated entity.
    - `yoy_value` number, nullable — Year-over-year comparison value from the prior period.
    - `yoy_change_pct` number, nullable — Year-over-year percentage change.
    - `source_text` string, nullable — The source text span from the filing where this value was found.
    - `source_url` string, uri — Direct link to the SEC filing. When available, includes a text fragment that highlights the source in the browser.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `402` — The request requires a paid subscription
- `403` — Enterprise access required

---

[API](https://skmtc.net/financialdatasets/apis/financial-datasets-api.md) · [All operations](https://skmtc.net/financialdatasets/apis/financial-datasets-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/financialdatasets/financial-datasets-api/revisions/df2363101891/schema)