{"uid":"cap_L_ezsjG5PWQRRJfU_ZZvT","slug":"financial-datasets-sector-kpi-metrics-8-k-earnings-5854075e","name":"Financial Datasets – Sector KPI Metrics (8-K Earnings)","description":"Sector-specific operating KPIs for a US-listed ticker, extracted from 8-K earnings releases: for example load factor, CET1 ratio, same-store sales or FFO per share, each with value, unit, period, year-over-year change and a link to the source text. Period quarterly or annual; filter by metric_name or report_period. Use when an agent needs the operating metrics a company reports outside its GAAP statements. Non-Professional use; Professional use needs a plan at financialdatasets.ai.","url":"https://api.financialdatasets.ai/kpi/metrics?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["ticker"],"properties":{"limit":{"type":"integer","default":4,"description":"Number of periods to return."},"cursor":{"type":"string","description":"Opaque pagination cursor from a previous response's next_page_url."},"period":{"enum":["quarterly","annual"],"type":"string","default":"quarterly","description":"Filter by period type: quarterly or annual."},"ticker":{"type":"string","description":"The ticker symbol."},"metric_name":{"type":"string","description":"Filter to a specific metric (e.g., load_factor, cet1_ratio)."},"report_period_gte":{"type":"string","description":"Only return metrics on or after this date (YYYY-MM-DD)."},"report_period_lte":{"type":"string","description":"Only return metrics on or before this date (YYYY-MM-DD)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.16","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.16/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.16","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.16","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2LmtuZ6pOIh9EtNurbnQA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.16","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns sector-specific operating KPIs (e.g. load factor, CET1 ratio, same-store sales, FFO per share) for a US-listed ticker, extracted from 8-K earnings releases, with value, unit, period, YoY change, and source link.","exampleAgentPrompt":"Pull the last 4 quarterly load factor readings for Delta Air Lines (ticker DAL) from its 8-K earnings releases, so I can see how capacity utilization has trended.","exampleUseCases":[{"title":"Airline capacity utilization trend","prompt":"Get me the past 8 quarters of load factor data for United Airlines (UAL) from its 8-K filings — I want to see how their capacity utilization has changed over time."},{"title":"Bank capital ratio monitoring","prompt":"What's JPMorgan's CET1 ratio for each of the last 4 quarters? Pull it from their earnings 8-Ks so I have the regulatory capital figures they actually reported."},{"title":"REIT funds from operations per share","prompt":"Show me the annual FFO per share for Realty Income (O) for the last 4 years — I need the operating metric they report in earnings releases, not just standard GAAP earnings."}],"resultDescription":"A list of sector-specific KPI objects, each containing: metric name, value, unit, period type, report period date, year-over-year change, and a direct link to the source text within the 8-K filing. Response also includes pagination metadata (next_page_url cursor) for retrieving additional records.","failureModes":["Ticker not covered or not US-listed — returns empty results or 404","metric_name filter does not match any available metric for that company — returns empty list","Date range filters too narrow — no results returned","Invalid period enum value — request rejected with validation error","Cursor pagination token expired or malformed — pagination error","Non-professional plan usage limits exceeded — 402 or plan upgrade required","Rate limit hit — 429 response"],"whenToPreferThis":"Use this endpoint when you need the non-GAAP, sector-specific operating metrics that companies report in 8-K earnings releases — metrics like load factor for airlines, CET1 ratio for banks, same-store sales for retailers, or FFO per share for REITs. This is the right choice when GAAP income statement, balance sheet, or cash flow data is insufficient and you need the KPIs management actually highlights in earnings. Prefer over general SEC filing parsers when you want pre-extracted, structured KPI data with YoY change already computed and source citations included.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-20T06:46:21.936Z","isFirstParty":false,"canonicalSlug":"financial-datasets-sector-kpi-metrics-8-k-earnings-5854075e"}