SEC filings & market structure

Fundamentals (XBRL)

Returns XBRL-tagged financial fundamentals from public-company 10-K and 10-Q filings, sourced from SEC EDGAR's company-facts API. Each record is one observation of one concept at one period end.

EndpointGET /v1/fundamentals

SourceSEC EDGAR XBRL

Authx-api-key — a free key works

What it returns

One record per result. Fields (from a live response):

Identity — company_cik, company_name
Subject — ticker
Dates — period_end, filed_date, fiscal_year, period_start, fiscal_period, scraped_at
The trade / event — category
Amounts — value
Provenance — accession_number, sec_source_url
Details — concept, concept_taxonomy, concept_label, unit, form, id, frame

Filters

ticker	Stock symbol filter, e.g. 'AAPL'. Case-insensitive.
company_cik	SEC CIK number. Alternative to ticker.
concept	Exact XBRL tag name (e.g., 'NetIncomeLoss', 'Revenues', 'Assets', 'CashAndCashEquivalentsAtCarryingValue'). Case-sensitive.
category	Bucket filter when you don't know the exact concept name.
fiscal_year	Filter to one fiscal year — the year the financials DESCRIBE (the company's own fiscal-year label, derived from the original filing), NOT the filing…
fiscal_period	Filter to one fiscal period.
form	Filter to one filing form.
since	ISO date YYYY-MM-DD. Applied to sort_by field.
until	ISO date YYYY-MM-DD.
latest_only	When true, return only the most-recent observation per (ticker × concept). Default false.
sort_by	Default period_end.
sort_order	Default desc.
limit	Default 50, max 500.

Example request

curl "https://api.keyvex.com/v1/fundamentals?ticker=AAPL&limit=1" \
  -H "x-api-key: YOUR_KEY"

Response

{
  "results": [
    {
      "ticker": "MDT",
      "concept": "EntityCommonStockSharesOutstanding",
      "concept_taxonomy": "dei",
      "accession_number": "0001628280-26-044354",
      "period_end": "2026-06-12",
      "concept_label": "Entity Common Stock, Shares Outstanding",
      "filed_date": "2026-06-18",
      "unit": "shares",
      "sec_source_url": "https://www.sec.gov/Archives/edgar/data/1613103/000162828026044354",
      "company_cik": "0001613103",
      "form": "10-K",
      "fiscal_year": 2026,
      "period_start": null,
      "fiscal_period": "FY",
      "scraped_at": "2026-06-21T08:25:39.548Z",
      "company_name": "Medtronic plc",
      "id": "0001613103-EntityCommonStockSharesOutstanding-2026-06-12-10-K-pit",
      "category": "entity",
      "value": 1280045190,
      "frame": "CY2026Q2I"
    }
  ],
  "count": 1,
  "has_more": true
}

Example questions you can answer

Income statement, balance sheet, and cash flow for a ticker.
Compare a financial line item across filings.

Related datasets

Insider TransactionsSEC Form 4 / 5 insider buys and sells.Planned Insider SalesSEC Form 144 Institutional Holdings (13F)SEC Form 13F Activist Stakes (13D / 13G)SEC Schedule 13D / 13G

Query Fundamentals (XBRL) from your AI

Hand any AI your key + the OpenAPI spec and it can pull this dataset directly. Free key = full data, 60 requests/day.

Get a free key OpenAPI spec → REST docs →

← All 60+ datasets