Skip to content

XBRL financial statements API

Annual, quarterly, and trailing-twelve-month statements from SEC XBRL filings, as standardized fields in a fixed order. Every value names the filing it came from.

What you get

Statements by period
Income statement and cash flow by year, quarter, or trailing twelve months. Balance sheet by year or quarter. Give a ticker or a CIK.
Every value has a source
Each value shows its period, its status, and its source filing: accession number, form type, and filing date.
Across companies
GET /v3/financials/frames returns one concept for one period across companies. GET /v3/financials/standard does the same for a standardized field.
As it was known
as_of returns each value as known from filings accepted by a given time, so a back-test sees only what was public then.

Example calls

Set SECBLAST_API_KEY to your key first.

Apple's three newest annual income statements:

Python · GET /v3/companies/{cik_or_ticker}/income-statement
import os
import requests

r = requests.get(
    "https://api.secblast.com/v3/companies/AAPL/income-statement",
    params={"period": "annual", "limit": "3"},
    headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

Revenues for calendar year 2025 across companies (first five):

Python · GET /v3/financials/frames
import os
import requests

r = requests.get(
    "https://api.secblast.com/v3/financials/frames",
    params={"concept": "us-gaap:Revenues", "frame": "CY2025", "limit": "5"},
    headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

In the API reference

Questions

What is XBRL?
The tagged financial data in a filing. Each tagged number is a fact with a concept, a period, a unit, and a value.
What does standardized mean?
Values come from each filing's own statements and are mapped to standard fields, such as revenue or net_income, by a fixed concept map. A blank is never shown as zero.
Can I get the numbers exactly as filed?
Yes. The filing facts route lists every XBRL fact of a filing with its exact value as filed.
What about quarters a company did not report?
Some are derived from other periods. For example, Q4 is the year minus nine months. A derived value shows its formula and inputs. See the periods route.

Make your first request

Create a key, then use it in the examples above. The fees page lists what each plan includes.