Financials migration
Move from legacy Stock Financials to annual or quarterly statements, or the latest combined TTM snapshot.
The legacy Stock Financials endpoint combined financial statements in one response. Choose the v2 resource according to the period and statement your application needs.
Annual and quarterly statements provide a series of reported periods. Financials TTM provides the most recent trailing-twelve-month snapshot across the three statements. A documentation migration does not update your existing API requests or parsers automatically.
Choose your data
- Annual and quarterly statements: reported periods for income, balance sheet and cash flow
- Latest TTM snapshot: the latest combined bs, cf and ic blocks
| You need | Use | Response |
|---|---|---|
| Annual or quarterly periods | Three dedicated statement endpoints; set freq=annual or freq=quarterly | data.financials on each endpoint |
| Latest TTM snapshot | Financials TTM; no freq parameter | data.bs, data.cf, data.ic |
Annual and quarterly statements
Request the statements you need separately. Set freq explicitly: it defaults to annual; use quarterly for quarterly periods. Provide exactly one of symbol or isin on every request.
- Income Statements: GET /v2/equities/income-statement
- Balance Sheets: GET /v2/equities/balance-sheets
- Cash Flow Statements: GET /v2/equities/cash-flow
Read each response's data.financials array. Match rows by their reporting period, frequency and reported currency rather than joining the arrays by position. Preserve missing or null values when reconciling statements.
{
"data": {
"currency": "USD",
"financials": [
{
"date": "2025-09-27",
"frequency": "annual",
"reportedCurrency": "USD",
"revenue": 416161000000,
"netIncome": 112010000000
}
]
}
}curl 'https://api.bavest.co/v2/equities/income-statement?symbol=AAPL&freq=annual' \
-H "x-api-key: $BAVEST_API_KEY"
curl 'https://api.bavest.co/v2/equities/balance-sheets?symbol=AAPL&freq=annual' \
-H "x-api-key: $BAVEST_API_KEY"
curl 'https://api.bavest.co/v2/equities/cash-flow?symbol=AAPL&freq=annual' \
-H "x-api-key: $BAVEST_API_KEY"curl 'https://api.bavest.co/v2/equities/income-statement?symbol=AAPL&freq=quarterly' \
-H "x-api-key: $BAVEST_API_KEY"The optional fields filter selects line-item response keys for that statement, such as revenue for income statements. This differs from the metricId filter on Equity Metrics. Check each endpoint's field list before filtering.
Latest TTM snapshot
Use GET /v2/equities/financials-ttm for the most recent combined snapshot. Provide exactly one of symbol or isin. This endpoint has no freq parameter and does not return a full annual or quarterly history.
- Open Financials TTM: parameters, full JSON example and response fields
The result contains data.bs for balance sheet, data.cf for cash flow and data.ic for income statement. The current example supplies the snapshot date as data.date and currency as data.currency. Read those values; if individual blocks also provide period metadata, preserve it when reconciling statements.
{
"data": {
"date": "2026-06-27",
"currency": "USD",
"bs": {
"totalAssets": 373221500000
},
"cf": {
"freeCashFlow": 136683000000
},
"ic": {
"revenue": 466823000000,
"netIncome": 128930000000
}
}
}curl 'https://api.bavest.co/v2/equities/financials-ttm?symbol=AAPL' \
-H "x-api-key: $BAVEST_API_KEY"Use fields to select statement line items. A field is retained only in the bs, cf or ic block that reports it; unsupported names can leave blocks empty. Use the dedicated statement endpoints when you need annual or quarterly periods.
Migration checklist
- Choose reported annual/quarterly periods or the latest TTM snapshot before changing the API call.
- Replace the legacy POST request with the documented GET request and query parameters. Send your API key in the
x-api-keyheader; the examples readBAVEST_API_KEYfrom the environment. - Update parsing to
data.financialsor thedata.bs/data.cf/data.icblocks. Do not assume the legacy response shape is unchanged. - Compare period ends, frequencies, currencies and the specific fields your application uses before replacing calculations. A latest TTM snapshot is not a substitute for every historical reporting period.
This page as Markdown: /docs/financials-migration.md

