POST /v1/data/sec/financials-as-reported/run
Pricing: $0.0045 per line item ($4.50 per 1,000).
Ways to call it
- By ticker: set
tickers(optional:statement,concepts,periodType,periods,fromYear,maxResults) - All companies: set
concept(optional:year,quarter,unit,maxResults)
Request
Send the inputs underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
One or more US stock tickers or SEC CIK numbers, e.g. AAPL, MSFT, BRK-B, 320193. SEC data covers US-listed companies only: non-US listings (RELIANCE.NS) and market indices (NIFTY, SENSEX) are refused with a clear error. One request reads them all.
A ready-made set of concepts to pull, e.g. Income statement = revenue, costs, operating income, net income and 17 more. Combines with Concepts: you get the set plus any concepts you pick. Left empty: Core, or only your picked Concepts if you pick any. “Only the concepts I pick” needs at least one concept.Allowed values:
core (Core (9 headline metrics)), incomeStatement (Income statement (21)), balanceSheet (Balance sheet (38)), cashFlow (Cash flow (16)), perShare (Per share, share counts and cover page (10)), all (All 85 curated concepts), custom (Only the concepts I pick).Annual (full-year figures) or Quarterly (three-month figures). Balance-sheet items are point-in-time values and come with either. Annual by default.Allowed values:
annual (Annual), quarterly (Quarterly).Number of most recent periods to return for each company and concept, e.g. 12 = the last 12 years with Annual, the last 12 quarters with Quarterly. Default 12.Min
1; max 200.Only periods ending in this year or later, e.g. 2020. Leave empty for no lower bound (SEC XBRL data starts around 2009). Applies before Periods.Min
2008; max 2100.A concept is the standard XBRL name for one financial line item, e.g. Revenues, NetIncomeLoss, Assets or EarningsPerShareDiluted. Pick from the 85 curated concepts; through the API any other XBRL tag a company reports also works, e.g. ifrs-full:Revenue or a company’s own custom tag. Added on top of Statement.85 allowed values, for example
Revenues (Revenue (Revenues)), RevenueFromContractWithCustomerExcludingAssessedTax (Revenue from contracts with customers (RevenueFromContractWithCustomerExcludingAssessedTax)), SalesRevenueNet (Net sales, pre-2018 tag (SalesRevenueNet)), RevenuesNetOfInterestExpense (Revenue net of interest expense (banks) (RevenuesNetOfInterestExpense)), CostOfRevenue (Cost of revenue (CostOfRevenue)), CostOfGoodsAndServicesSold (Cost of goods and services sold (CostOfGoodsAndServicesSold)), GrossProfit (Gross profit (GrossProfit)), OperatingExpenses (Operating expenses, total (OperatingExpenses)), ResearchAndDevelopmentExpense (Research and development expense (ResearchAndDevelopmentExpense)), SellingGeneralAndAdministrativeExpense (Selling, general and administrative expense (SellingGeneralAndAdministrativeExpense)). Fetch the full list with GET /v1/data/sec/financials-as-reported?expand=options.All companies mode: the one line item to rank every SEC filer by, e.g. Revenues, NetIncomeLoss or Assets. Pick from the 85 curated concepts; through the API any other us-gaap or dei concept name also works. A concept SEC has no figures for returns no rows.85 allowed values, for example
Revenues (Revenue (Revenues)), RevenueFromContractWithCustomerExcludingAssessedTax (Revenue from contracts with customers (RevenueFromContractWithCustomerExcludingAssessedTax)), SalesRevenueNet (Net sales, pre-2018 tag (SalesRevenueNet)), RevenuesNetOfInterestExpense (Revenue net of interest expense (banks) (RevenuesNetOfInterestExpense)), CostOfRevenue (Cost of revenue (CostOfRevenue)), CostOfGoodsAndServicesSold (Cost of goods and services sold (CostOfGoodsAndServicesSold)), GrossProfit (Gross profit (GrossProfit)), OperatingExpenses (Operating expenses, total (OperatingExpenses)), ResearchAndDevelopmentExpense (Research and development expense (ResearchAndDevelopmentExpense)), SellingGeneralAndAdministrativeExpense (Selling, general and administrative expense (SellingGeneralAndAdministrativeExpense)). Fetch the full list with GET /v1/data/sec/financials-as-reported?expand=options.All companies mode: the calendar year, e.g. 2023. SEC lines each company’s fiscal year up with the closest calendar year. Left empty: the latest full calendar year.Min
2009; max 2100.All companies mode: the whole year or one calendar quarter. Balance-sheet items and share counts are read as of the period end (for Full year, Dec 31). Full year by default.Allowed values:
full (Full year), Q1 (Q1 (Jan to Mar)), Q2 (Q2 (Apr to Jun)), Q3 (Q3 (Jul to Sep)), Q4 (Q4 (Oct to Dec)).All companies mode: the unit the values are reported in. Left empty: USD, or USD per share for EPS and dividends per share, or shares for share counts. Companies that report in another unit are not included.Allowed values:
USD, USD/shares (USD per share), shares (Shares), EUR, pure (Pure number).How many rows to return in total. Defaults to 50; use 0 for all with Tickers. All companies returns the largest companies first, up to 1000 per run (0 is not allowed there).
Example
Response fields
Each row indata is one line item, keyed by these fields.
Example response
Abridged: long text and lists are shortened.Related APIs
For the cash flow statement laid out by period usesec/cashflow-as-reported; for headline KPIs and guidance from earnings releases use sec/kpi-guidance; for non-US tickers use yahoo-finance/income-statements.