Financial Statements
GET/v1/financials/{ticker}
Retrieve reported financial statement line items for a ticker. Choose statement type income, balance-sheet or cash-flow and period annual or quarterly; limit controls how many historical periods are returned (default 40). Each period includes the full JSON breakdown of line items from SEC filings - revenue, net income, assets, cash flow and hundreds of other fields - suitable for models, comparables and fundamental screens.
Use cases
- Income statement, balance sheet and cash flow displays
- Multi-quarter revenue and margin trend analysis
- Cross-company fundamental comparison (e.g. Google vs Meta growth)
- Feeding statement data into valuation and credit models
Input parameters
Required
| Parameter | Type | Description |
|---|---|---|
| ticker(*) | string | Ticker. |
| statement | string | income | balance-sheet | cash-flow (default income). |
| period | string | annual | quarterly (default annual). |
| limit | integer | Max periods, 1-400 (default 40). |
Output parameters
| Field | Type | Description |
|---|---|---|
| ticker | string | Ticker. |
| statement | string | Statement type returned: income, balance-sheet, or cash-flow. |
| period | string | annual or quarterly. |
| results | array | Statement periods, most recent first. |
| results[].date | string | Period end date (YYYY-MM-DD). |
| results[].period | string | Fiscal period label (e.g. FY or Q1). |
| results[].fiscalYear | integer | Fiscal year. |
| results[].reportedCurrency | string | Reporting currency. |
| results[].filingDate | string | SEC filing date. |
| results[].acceptedDate | string | SEC acceptance timestamp. |
| results[].revenue | float | Total revenue (income statement). |
| results[].grossProfit | float | Gross profit (income statement). |
| results[].netIncome | float | Net income (income statement). |
| results[].eps | float | Earnings per share when available. |
| count | integer | Number of periods returned. |
from vantafin import RESTClient
client = RESTClient("vf-live-your_api_key")
result = client.get_financials("AAPL", statement="income", period="annual")
print(result){
"ticker": "AAPL",
"statement": "income",
"period": "annual",
"results": [
{
"date": "2025-09-27",
"period": "FY",
"fiscalYear": 2025,
"reportedCurrency": "USD",
"filingDate": "2025-10-31",
"acceptedDate": "2025-10-31 06:01:26",
"eps": 7.49,
"ebit": 132729000000,
"ebitda": 144427000000,
"revenue": 416161000000,
"netIncome": 112010000000,
"epsDiluted": 7.46,
"grossProfit": 195201000000,
"costOfRevenue": 220960000000,
"otherExpenses": 0,
"interestIncome": 0,
"costAndExpenses": 283111000000,
"incomeBeforeTax": 132729000000,
"interestExpense": 0,
"operatingIncome": 133050000000,
"incomeTaxExpense": 20719000000,
"netInterestIncome": 0,
"operatingExpenses": 62151000000,
"bottomLineNetIncome": 112010000000,
"netIncomeDeductions": 0,
"weightedAverageShsOut": 14948500000,
"weightedAverageShsOutDil": 15004697000,
"depreciationAndAmortization": 11698000000,
"otherAdjustmentsToNetIncome": 0,
"sellingAndMarketingExpenses": 0,
"totalOtherIncomeExpensesNet": -321000000,
"researchAndDevelopmentExpenses": 34550000000,
"generalAndAdministrativeExpenses": 27601000000,
"netIncomeFromContinuingOperations": 112010000000,
"netIncomeFromDiscontinuedOperations": 0,
"nonOperatingIncomeExcludingInterest": 321000000,
"sellingGeneralAndAdministrativeExpenses": 27601000000
},
{
"date": "2024-09-28",
"period": "FY",
"fiscalYear": 2024,
"reportedCurrency": "USD",
"filingDate": "2024-11-01",
"acceptedDate": "2024-11-01 06:01:36",
"eps": 6.11,
"ebit": 123485000000,
"ebitda": 134930000000,
"revenue": 391035000000,
"netIncome": 93736000000,
"epsDiluted": 6.08,
"grossProfit": 180683000000,
"costOfRevenue": 210352000000,
"otherExpenses": 0,
"interestIncome": 0,
"costAndExpenses": 267819000000,
"incomeBeforeTax": 123485000000,
"interestExpense": 0,
"operatingIncome": 123216000000,
"incomeTaxExpense": 29749000000,
"netInterestIncome": 0,
"operatingExpenses": 57467000000,
"bottomLineNetIncome": 93736000000,
"netIncomeDeductions": 0,
"weightedAverageShsOut": 15343783000,
"weightedAverageShsOutDil": 15408095000,
"depreciationAndAmortization": 11445000000,
"otherAdjustmentsToNetIncome": 0,
"sellingAndMarketingExpenses": 18639000000,
"totalOtherIncomeExpensesNet": 269000000,
"researchAndDevelopmentExpenses": 31370000000,
"generalAndAdministrativeExpenses": 7458000000,
"netIncomeFromContinuingOperations": 93736000000,
"netIncomeFromDiscontinuedOperations": 0,
"nonOperatingIncomeExcludingInterest": -269000000,
"sellingGeneralAndAdministrativeExpenses": 26097000000
}
],
"count": 40
}