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_ofreturns 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:
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):
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
- GET /v3/companies/{cik_or_ticker}/income-statementGet a company's income statement by period.
- GET /v3/companies/{cik_or_ticker}/standardGet a company's standardized financial fields by period.
- GET /v3/financials/framesGet one concept for one period across companies.
- GET /v3/financials/seriesGet a company's values for one concept over time.
- GET /v3/filings/{accession}/factsList every XBRL fact of a filing, as filed.
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
revenueornet_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.