APIs

Financials API

As-filed period series and Street earnings calendar — same fields as the Terminal Financials tab and get_company_financials.

Endpoints

MCP	HTTP
get_company_financials	GET /api/v1/companies/financials?ticker=&market_id=&fiscal_year_from=&fiscal_year_to=&line_items= Optional as_of=YYYY-MM-DD for point-in-time as filed on that date.
get_company_financials (earnings)	GET /api/v1/companies/{market}/{ticker}/earnings-releases
— (REST)	GET /api/v1/kpi-taxonomy Canonical line-item vocabulary.
— (REST)	GET /api/v1/filings/{id}/kpis Golden KPIs for one resolved filing.

Example

curl -s -H "X-API-Key: of_your_key" \
  "https://api.openfilings.org/api/v1/companies/financials?ticker=AAPL&market_id=us&fiscal_year_from=2020&fiscal_year_to=2024&line_items=revenue,ebitda,net_income"

Python SDK:

from openfilings import Client

client = Client(api_key="of_...")
series = client.companies.financials(
    ticker="AAPL",
    market_id="us",
    fiscal_year_from=2020,
    fiscal_year_to=2024,
    line_items=["revenue", "ebitda", "net_income"],
)
# series.earnings → Street calendar when present

Notes

Call list_markets / GET /api/v1/markets first for allowed market_id values.
EU/EEA country market_id also resolves eu (ESEF) financials.
Prefer line_items from the KPI taxonomy — see /standardized-financials.

Quick start →Full REST table →Authentication →Auth: X-API-Key