Home / Products / Extraction & conversion
Extraction & conversion

Financial Statements API: income statement, balance sheet and cash flow by ticker

Income statement, balance sheet and cash flow for the latest 10-K or 10-Q of any company, by ticker, as JSON or an Excel workbook.

curl -H "Authorization: Bearer $SECFEED_KEY" \
  "https://secfeedapi.com/v1/financial-statements?ticker=NVDA&formType=10-K"
import os, requests

r = requests.get(
    "https://secfeedapi.com/v1/financial-statements",
    params={'ticker': 'NVDA', 'formType': '10-K'},
    headers={"Authorization": f"Bearer {os.environ['SECFEED_KEY']}"},
)
print(r.json())

Overview

Most people do not want an accession number, they want Apple's last three annual income statements. The Financial Statements API takes a ticker or CIK and a form type, finds the latest n filings and returns their statements from XBRL.

Each statement is keyed by concept with every reported period, so the current year and the comparatives come back together. For spreadsheets, the xlsx endpoint writes one sheet per statement with periods as columns.

What you get

Built for developers who would rather not parse EDGAR.

By ticker

Pass ticker or cik, formType (10-K or 10-Q) and n for how many filings.

Three core statements

StatementsOfIncome, BalanceSheets and StatementsOfCashFlows with all periods reported.

Excel export

One filing as an .xlsx workbook: a sheet per statement, periods as columns.

Straight from XBRL

Numbers come from the filing's own tagged data, not from a third party.

Endpoints

Authenticate with Authorization: Bearer YOUR_KEY. Responses are JSON.

GET/v1/financial-statementsDocs →

Income statement, balance sheet, cash flow (totals) for the latest n 10-K or 10-Q.

Parameters: ticker | cik, formType, n

GET/v1/financial-statements/xlsxDocs →

One filing's statements as an Excel workbook: a sheet per statement, periods as columns.

Parameters: accessionNo, cik

Response fields

The main fields in every result. The raw filing data is always one level down.

FieldMeaning
accessionNoThe 10-K or 10-Q the statements come from.
StatementsOfIncomeRevenues, CostOfRevenue, OperatingIncomeLoss, NetIncomeLoss and the rest, by period.
BalanceSheetsAssets, Liabilities, StockholdersEquity and line items at each balance sheet date.
StatementsOfCashFlowsOperating, investing and financing cash flows by period.

Use cases

Datasets behind this API

The SEC forms this API reads, with live filing counts.

Tutorials

FAQ

How many years do I get?

Each 10-K includes the current year and the comparative years the company presented, usually two or three. Pass n to get more filings.

Are the numbers adjusted?

No. Values are exactly what the company reported in XBRL, with the unit and decimals it used.

Try the Financial Statements free

500 API calls a month on the free plan. No sales call.

Get free API key →