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. SEC API 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: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/statements/income_statement?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: $SECAPI_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/{statement_key}Income statement, balance sheet, or cash flow statement data
GET /v1/statements/allAll three statements combined

​
Why SEC API for financial statements

FeatureSEC APIRaw EDGARFinancial DatasetsIntrinio
Normalized schemaYesNo (raw XBRL)YesYes
All three statementsYesYes (raw)YesYes
REST APIYesNoYesYes
Cross-company consistencyYesNoPartialYes
Historical depth2009+2009+ (XBRL era)2010+2008+
SDK and REST guidesPython and JavaScript SDKs, plus REST examplesNoPython onlyYes
PricingPay-as-you-goFree (raw)$19+/mo$500+/mo

​
Get Started

Get your API key

Create an API key and start pulling financial statements in under 60 seconds.