Stock market data infrastructure
Financial statements API reference
Read financial periods, currencies, source attribution, quarterly cash-flow basis, and trailing-twelve-month response metadata.
Documentation revised
Request explicit periods
GET /api/v1/companies/{ticker}/financials returns ticker, company_id, periods, and total_periods. limit is bounded from 1 to 100 and defaults to 20. period_type filters stored labels such as FY or Q1; period=ttm requests the aggregate path. An omitted period filter can return mixed reporting frequencies.
Retain basis and provenance
Each period carries currency, primary_source, and optional sources mapping populated fields to source identifiers. Keep period_end, fiscal_year, period_type, filed_date, and updated_at separate. They describe reporting identity, filing availability, and storage updates respectively, not interchangeable dates.
Do not sum cumulative cash flow
Quarterly cash_flow_basis can be standalone, cumulative, or unknown. cash_flow=standalone requests de-cumulation; period=ttm combines eligible standalone quarter flows and the latest balance-sheet instants. Inspect ttm_quarters and missing values before using the aggregate. Statement endpoints reject funds that do not have this equity statement contract.