Structured XBRL financial data from SEC filings
Retrieve structured financial values reported to the SEC in XBRL, via data.sec.gov. Use this endpoint when you need numbers (net income, assets, shares outstanding, and so on); use sec-filing to find filing documents. Three types: “concept” returns one line item for one company over time; “facts” returns a catalog of every concept a company reports (or normalized facts for the concepts you name); “frames” returns one concept across all reporting companies for one calendar period. Each fact links back to its EDGAR filing index via secUrl. The same value is re-reported in later filings as a prior-period comparative, so by default (dedupe: true) only facts the SEC assigned a calendar frame are returned; set dedupe to false for every reported fact. Free.
Authorizations
API key starting with sk_case_
Body
XBRL query parameters. The fields used depend on type.
concept: one line item for one company over time. facts: all concepts for one company (catalog, or values for the concepts you list). frames: one concept across all companies for one period.
concept, facts, frames Company CIK, padded or unpadded (concept and facts). Provide exactly one of cik or ticker.
Company ticker (concept and facts). Provide exactly one of cik or ticker.
XBRL taxonomy. For facts it only filters the catalog and has no default.
us-gaap, ifrs-full, dei, srt XBRL element name such as NetIncomeLoss (required for concept and frames)
facts only. "taxonomy:tag" strings or bare tags (default us-gaap). Omit to get the concept catalog, which has no values.
Unit such as USD, shares, or USD/shares. Optional filter for concept; defaults to USD for frames (the SEC URL form USD-per-shares is also accepted).
frames only, required. CY2024 = annual duration, CY2024Q1 = quarterly duration, CY2024Q1I = instantaneous (balance sheet items).
^CY\d{4}(Q[1-4]I?)?$frames only. Restrict results to these CIKs (peer set).
frames only. Restrict results to these tickers (peer set).
frames only. Sort order by value.
value_desc, value_asc concept and facts. Filter by SEC form type such as 10-K or 10-Q.
concept and facts. Filter by fiscal period.
FY, Q1, Q2, Q3 concept and facts. Only facts whose period end date is on or after this date (YYYY-MM-DD).
concept and facts. Only facts whose period end date is on or before this date (YYYY-MM-DD).
concept and facts. When true, keep only facts the SEC assigned a calendar frame (its canonical fact per period), dropping prior-period comparatives re-reported in later filings. When false, return every reported fact.
Maximum rows to return
1 <= x <= 100Result offset for pagination
x >= 0Response
XBRL data retrieved successfully
concept, facts, frames Padded CIK (concept and facts)
concept and frames
frames only
frames only
concept and facts with concepts
Rows matching before pagination
concept, and facts when concepts is provided
facts without concepts: the catalog of concepts the company reports
frames: one row per reporting company

