FIfinancialdatasets
KPIs

Get KPI metrics

Changed on

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.

get/kpi/metrics

Request

  • Base URL
    https://api.financialdatasets.ai
  • Auth
    API key in header X-API-KEY

Query parameters

tickerstring required

The ticker symbol.

metric_namestring

Filter to a specific metric (e.g., load_factor, cet1_ratio).

period'quarterly' | 'annual'

Filter by period type: quarterly or annual.

report_period_gtestring date

Only return metrics on or after this date (YYYY-MM-DD).

report_period_ltestring date

Only return metrics on or before this date (YYYY-MM-DD).

limitinteger

Number of periods to return. Returns all metrics for the N most recent periods. This is the total across all pages, not a page size: each page holds up to 10 records, linked by next_page_url.

cursorstring

Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.

Response

KPI metrics response

next_page_urlstring

Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.

Example response

{
  "kpi_metrics": [
    {
      "ticker": "DAL",
      "metric_name": "load_factor",
      "value": 82,
      "unit": "%",
      "period": "Q4 2025",
      "period_type": "quarterly",
      "segment": "Commercial Engines & Services",
      "yoy_value": 84,
      "yoy_change_pct": -2.381,
      "source_text": "Passenger load factor",
      "source_url": "https://www.sec.gov/Archives/edgar/data/27904/000002790426000008/deltaairlinesannouncesdece.htm"
    }
  ]
}

Changes

  • 5872e134b56cRevision changes
    • breaking

      removed the media type application/json for the response with the status

    • info

      added the new optional query request parameter cursor

    • info

      added the optional property to the response with the status