SEC Financial Statements API - XBRL Fundamentals (Calcbench)

Pull standardized SEC XBRL fundamentals, as-reported financial statements, segment revenue, raw XBRL facts, 10-K and 10-Q footnote text, SEC filings and company lists for US public companies from the Calcbench API into a dataset, a spreadsheet or a warehouse. Bring your own API key: the run signs in with your own calcbench.com account, reads only, and charges only for rows that carry data.

What it collects

• Standardized fundamentals: revenue, net income, diluted EPS, operating cash flow, capex, equity and the rest of Calcbench's standardized metrics, comparable across companies, annual, quarterly, combined or trailing twelve months, for one year, a range of years or all history. Optional point in time data shows when each value was first published and every later revision.
• As-reported face statements: the income statement, balance sheet, cash flow statement, statement of stockholders equity and statement of comprehensive income exactly as the company filed them, one row per line with its XBRL tag, its standardized name and the value of every period shown.
• Segments and breakouts: operating and geographic segment revenue, operating income, assets and capex, customer and supplier concentration, debt instruments, intangible assets, fair value levels, pensions, business combinations and more.
• As-reported XBRL facts: any XBRL tag as filed, including company extension tags, with its dimensions, period, unit and filing.
• Disclosures and footnotes: full text search across 10-K, 10-Q and 8-K text in Lucene syntax, or named sections such as Risk Factors, MD&A, Revenue Recognition and Income Taxes, with an option to read each section's full text.
• SEC filings: 10-K, 10-Q, 8-K, earnings press releases, guidance updates, proxies, comment letters and more, with filing dates, fiscal periods and SEC links.
• Companies: tickers, CIK codes, SIC and NAICS codes and latest filing dates, by ticker, by index (Dow Jones, S&P 500) or by industry code.
• Standardized metrics dictionary: every metric name with its section, unit and definition, to pick metrics from.
• Read only, pay per result, bring your own key.

How to use it

1. You need a calcbench.com account whose subscription includes API access. Calcbench has no API keys: its API, like its official Python client, signs in with the account's email and password.
2. Put the email into Calcbench email and the password into Calcbench password (both stored as secrets), or set the DATA_API_KEY environment secret on the actor as email:password.
3. Pick What to read, list the Companies as tickers or CIK codes, set the year, period and filters, and start the run.

A run without credentials ends cleanly with a message asking for them, before any request is sent. A rejected email and password ends the run the same way.

Input

Field	What it does
What to read	Standardized fundamentals (default), as-reported face statement, segments and breakouts, as-reported XBRL facts, disclosures and footnotes, SEC filings, companies or the standardized metrics dictionary.
Companies	Tickers or SEC CIK codes, one per line. Each is looked up first; one Calcbench does not know becomes a free row saying so. Calcbench keeps one ticker per filer (Berkshire Hathaway is BRKA).
Standardized metrics	Metric names for standardized fundamentals; empty reads every metric.
Fiscal year, End year	One fiscal year, or a range; empty reads all history.
Fiscal period	Full year or one quarter, with a single fiscal year.
Period type	Annual, quarterly, annual and quarterly, or trailing twelve months.
Point in time	Publication timestamps and revisions for standardized fundamentals.
Statement, All history	Which face statement, and every period instead of the latest four.
Breakouts	Segment and breakout names, such as OperatingSegmentRevenue.
XBRL tags	Tags to read as filed, such as Revenues.
Search text, Disclosure names, Include disclosure text	Disclosure search and whether to read each section's text.
Start date, End date, Filing types, Include non-XBRL filings	SEC filings filters.
Index, SIC codes, NAICS codes	Company list filters.
Every metric	The full metrics dictionary.
Maximum results	Row cap for the whole run.
Requests per minute	Pacing.
Calcbench email, Calcbench password	Your own calcbench.com login, as secrets.

Access and licensing on the Calcbench side

• What you can read is what your Calcbench subscription includes. A data set outside it (for example segments, point in time data or disclosures on a plan without them) is refused, and the run ends with a message saying so before anything is charged.
• The password is sent only to calcbench.com, in the same login form the official Python client uses, never in a URL. It is never logged and is stripped from every error text.
• Calcbench's End User License Agreement grants use for the licensee's own internal business purposes and forbids sharing, timesharing or service bureau use. This actor does not change those terms: keep the run's dataset private and use it within your own organization unless your Calcbench agreement allows more.

FAQ

What is the Calcbench API?

Calcbench is a New York financial data company that extracts and standardizes the numbers and text in SEC filings (10-K, 10-Q, 8-K earnings releases and proxies) for US public companies, from 2009 onward. Its API at calcbench.com is documented in a Swagger definition the site serves and in the official Python client, calcbench_api_client, on GitHub. This actor wraps that API's main read endpoints: standardized data, face statements, segments, raw XBRL, disclosures, filings and companies. The docs and the live host were checked on 2026-10-09.

Do I need a Calcbench account?

Yes. This actor is bring-your-own-key and never ships credentials. Calcbench's API signs in with the email and password of a calcbench.com account rather than an API key, so you give the actor that pair as secrets. API access is part of Calcbench's paid subscriptions; ask Calcbench if your account does not have it.

How do I get standardized revenue and EPS for several companies?

Pick standardized fundamentals, list the tickers, add Revenue and EPSDiluted to the standardized metrics, set the period type to quarterly and a fiscal year and end year, and run. Each row is one company, metric and period with its value, filing and dates.

How do I download an income statement as reported?

Pick the as-reported face statement, choose the income statement, annual or quarterly, and tick all history for every period on file. Each row is one statement line with its XBRL tag and its value for every period column.

Can I get segment revenue?

Yes. Pick segments and breakouts, keep OperatingSegmentRevenue or add GeographicalSegmentRevenue, and list the companies. Each row is one segment value for one period with the segment label.

How do I search 10-K footnotes?

Pick disclosures and footnotes and type search text such as "goodwill impairment", or name sections such as Risk Factors. List companies, or set a fiscal year to search every company. Tick include disclosure text to get each section's full text.

Why does a ticker come back as not found?

Calcbench lists each SEC filer under one ticker, so share-class tickers such as BRK.B may not match (Berkshire Hathaway is BRKA). The actor looks every company up before reading data and returns a free row for each one Calcbench does not know. Use the 10 digit SEC CIK code instead, or find the ticker with the companies mode.

How is it priced?

Pay per result: 0.005 USD per standardized, segment or XBRL data point, filing, company or metric definition; 0.01 USD per face statement line (with all its periods) or disclosure match; 0.02 USD per disclosure with its full text. Requests that find nothing are free. Your Calcbench subscription applies separately.

Example output

{
  "mode": "standardized",
  "modeLabel": "Standardized fundamentals",
  "recordType": "dataPoint",
  "identifier": "MSFT",
  "found": true,
  "id": "MSFT|Revenue|2025|annual||",
  "ticker": "MSFT",
  "companyName": null,
  "metric": "Revenue",
  "fiscalYear": 2025,
  "fiscalPeriod": "annual",
  "value": 281724000000,
  "date": "2025-06-30T00:00:00",
  "url": null,
  "retrievedAt": "2026-10-09T09:15:02.118Z",
  "note": null,
  "fiscal_year": 2025,
  "fiscal_period": 0,
  "provider_metric": "Revenue",
  "provider_value": 281724000000,
  "calendar_year": 2025,
  "calendar_period": 2,
  "preliminary": false,
  "XBRL": true,
  "CIK": "0000789019",
  "filing_type": "annualQuarterlyReport",
  "period_start": "2024-07-01T00:00:00"
}

Values are illustrative; every provider field is passed through as the provider names it. Provider fields that share a name with a common column (such as a data point's value or metric) are kept with a provider_ prefix.

Keyword map

SEC financial statements API, XBRL financial data API, standardized fundamentals API, 10-K 10-Q data API, as-reported financial statements, income statement API, balance sheet API, cash flow statement API, segment revenue data, geographic segment data, XBRL tag data, SEC footnote search, 10-K text search, earnings press release data, SEC filings API, point in time fundamentals, company fundamentals by CIK, Calcbench API, Calcbench data.