SEC XBRL Financial Data — Company Facts & Frame Data

Pricing

Rating

Developer

Actor stats

Categories

Share

Download structured XBRL financial data from the SEC EDGAR public API. Two modes: pull all accounting data for specific companies by ticker or CIK, or retrieve a cross-company snapshot of any single financial concept for a reporting period.

Modes

company-facts (default)

Fetch all XBRL facts (or a filtered subset) for one or more companies.

{
"mode":"company-facts",
"tickers":["AAPL","MSFT","GOOGL"],
"concepts":["Assets","Revenues","NetIncomeLoss"],
"taxonomies":["us-gaap"],
"unitsFilter":["USD"],
"maxRecordsPerCompany":100
}

frame-data

Get all companies' reported value for a single concept in a specific period.

{
"mode":"frame-data",
"taxonomy":"us-gaap",
"concept":"Assets",
"unit":"USD",
"period":"CY2023Q4I"
}

Example output record (company-facts)

{
"cik":"0000320193",
"ticker":"AAPL",
"companyName":"Apple Inc.",
"taxonomy":"us-gaap",
"concept":"Assets",
"label":"Assets",
"description":"Sum of the carrying amounts as of the balance sheet date of all assets...",
"unit":"USD",
"end":"2024-09-28",
"val":364980000000,
"accn":"0000320193-24-000123",
"fy":2024,
"fp":"FY",
"form":"10-K",
"filed":"2024-11-01",
"fetchedAt":"2025-01-01T00:00:00.000Z"
}

Period format for frame-data

Common concepts

• Assets, Liabilities, StockholdersEquity
• Revenues, NetIncomeLoss, OperatingIncomeLoss
• EarningsPerShareBasic, EarningsPerShareDiluted
• CashAndCashEquivalentsAtCarryingValue

Use cases

• Financial analysis and peer benchmarking
• Quantitative investing and factor research
• Accounting research and academic studies
• Industry-wide financial snapshots
• ESG and financial health scoring