Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.secapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

SEC Financial Statements API

Public companies report financial statements in XBRL format embedded in their SEC filings, but the raw data requires complex parsing and normalization. Datastream extracts, standardizes, and serves income statements, balance sheets, and cash flow statements as clean JSON — ready to compare across companies and time periods.

Capabilities

Three core statements

Income statement, balance sheet, and cash flow statement extracted and normalized for every annual and quarterly filing.

Cross-company comparability

XBRL concepts mapped to a consistent schema so revenue from Apple and revenue from Microsoft use the same field name.

Period flexibility

Request annual or quarterly data. Pull multiple periods in a single call for trend analysis.

As-reported fidelity

Financial data matches what the company reported. Restated values flagged when available.

Quick start

Get Apple’s annual income statement:
curl -H "x-api-key: $OMNI_DATASTREAM_API_KEY" \
  "https://api.secapi.ai/v1/statements/income?ticker=AAPL&period=annual&limit=1"
{
  "ticker": "AAPL",
  "period": "2024-09-28",
  "period_type": "annual",
  "revenue": 391035000000,
  "cost_of_revenue": 210352000000,
  "gross_profit": 180683000000,
  "operating_income": 123216000000,
  "net_income": 93736000000,
  "eps_basic": 6.11,
  "eps_diluted": 6.08
}
Pull balance sheet data for multiple quarters:
curl -H "x-api-key: $OMNI_DATASTREAM_API_KEY" \
  "https://api.secapi.ai/v1/statements/balance-sheet?ticker=AAPL&period=quarterly&limit=4"

Use cases

Financial modeling

Pull historical financials to build DCF models, comparable company analyses, and financial projections programmatically.

Stock screeners

Screen the entire SEC universe by financial metrics — revenue growth, profit margins, debt ratios, and more — using normalized data.

AI-powered analysis

Feed structured financial data to LLMs for automated earnings analysis, trend detection, and anomaly identification.

Portfolio analytics

Track financial health metrics across a portfolio of holdings with consistent, comparable data from a single API.

API endpoints

EndpointDescription
GET /v1/statements/incomeIncome statement data
GET /v1/statements/balance-sheetBalance sheet data
GET /v1/statements/cash-flowCash flow statement data
GET /v1/statements/allAll three statements combined

Why Datastream for financial statements

FeatureDatastreamRaw EDGARFinancial DatasetsIntrinio
Normalized schemaYesNo (raw XBRL)YesYes
All three statementsYesYes (raw)YesYes
REST APIYesNoYesYes
Cross-company consistencyYesNoPartialYes
Historical depth2009+2009+ (XBRL era)2010+2008+
SDKs (Python, JS, Rust, Go)YesNoPython onlyYes
PricingPay-as-you-goFree (raw)$19+/mo$500+/mo

Get started

Get your API key

Start pulling financial statements in under 60 seconds. 250 free API calls per month.