FMP Node API Documentation
Financial Endpoints
The Financial Endpoints provide access to financial statements, ratios, and fundamental data for companies.
Available Methods
| Method | Endpoint | Description |
|---|---|---|
| GET | /stable/income-statement?symbol={symbol} | Get income statement data |
| GET | /stable/balance-sheet-statement?symbol={symbol} | Get balance sheet data |
| GET | /stable/cash-flow-statement?symbol={symbol} | Get cash flow statement data |
| GET | /stable/key-metrics?symbol={symbol} | Get key financial metrics |
| GET | /stable/ratios?symbol={symbol} | Get financial ratios |
| GET | /stable/enterprise-values?symbol={symbol} | Get enterprise value data |
| GET | /stable/cash-flow-statement-growth?symbol={symbol} | Get cash flow growth metrics |
| GET | /stable/income-statement-growth?symbol={symbol} | Get income statement growth metrics |
| GET | /stable/balance-sheet-statement-growth?symbol={symbol} | Get balance sheet growth metrics |
| GET | /stable/financial-growth?symbol={symbol} | Get general financial growth metrics |
| GET | /stable/earnings?symbol={symbol} | Get historical earnings data |
| GET | /earnings-surprises/{symbol} | Get earnings surprises data |
| GET | /stable/financial-scores?symbol={symbol} | Get financial health scores (Altman Z + Piotroski) |
| GET | /stable/key-metrics-ttm?symbol={symbol} | Get trailing-twelve-month (TTM) key metrics |
| GET | /stable/ratios-ttm?symbol={symbol} | Get trailing-twelve-month (TTM) financial ratios |
| GET | /stable/revenue-product-segmentation?symbol={symbol} | Get revenue broken down by product line |
| GET | /stable/revenue-geographic-segmentation?symbol={symbol} | Get revenue broken down by geographic region |
Get Income Statement
Retrieve income statement data including revenue, expenses, and profit metrics.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" (default: "annual") |
| limit | number | No | Number of periods to retrieve (default: 5) |
Example Response
Get Balance Sheet
Retrieve balance sheet data including assets, liabilities, and equity.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" (default: "annual") |
| limit | number | No | Number of periods to retrieve (default: 5) |
Example Response
Get Cash Flow Statement
Retrieve cash flow statement data including operating, investing, and financing activities.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" (default: "annual") |
| limit | number | No | Number of periods to retrieve (default: 5) |
Example Response
Get Financial Ratios
Retrieve key financial ratios and metrics for analysis.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" (default: "annual") |
| limit | number | No | Number of periods to retrieve (default: 5) |
Example Response
Get Key Metrics
Retrieve key financial metrics including valuation ratios, profitability metrics, and efficiency ratios.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" (default: "annual") |
| limit | number | No | Number of periods to retrieve (default: 5) |
Example Response
Get Enterprise Value
Retrieve enterprise value data including market capitalization, debt, and cash calculations.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" (default: "annual") |
| limit | number | No | Number of periods to retrieve (default: 5) |
Example Response
Get Cashflow Growth
Retrieve cash flow growth metrics showing period-over-period changes in cash flow components.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" (default: "annual") |
| limit | number | No | Number of periods to retrieve (default: 5) |
Example Response
Get Income Growth
Retrieve income statement growth metrics showing period-over-period changes in revenue, expenses, and profitability.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" (default: "annual") |
| limit | number | No | Number of periods to retrieve (default: 5) |
Example Response
Get Balance Sheet Growth
Retrieve balance sheet growth metrics showing period-over-period changes in assets, liabilities, and equity.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" (default: "annual") |
| limit | number | No | Number of periods to retrieve (default: 5) |
Example Response
Get Financial Growth
Retrieve comprehensive financial growth metrics including revenue, earnings, and cash flow growth over multiple time periods.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" (default: "annual") |
| limit | number | No | Number of periods to retrieve (default: 5) |
Example Response
Get Earnings Historical
Retrieve historical and upcoming earnings announcements for a specific company, including estimated and actual earnings per share (EPS) and revenue data.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| limit | number | No | Number of earnings announcements to retrieve (default: 5) |
Example Response
Get Earnings Surprises
Retrieve earnings surprises data showing the difference between estimated and actual earnings per share (EPS) for companies.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
Example Response
Get Financial Scores
Retrieve financial health scores for a company: the Altman Z-Score (bankruptcy-risk indicator) and the Piotroski Score (fundamental-strength score, 0-9), plus the underlying components. Returns a single snapshot object.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
Example Response
Get Key Metrics (TTM)
Retrieve a single trailing-twelve-month snapshot of key valuation and performance metrics (EV multiples, returns, per-share figures). More token-efficient than the multi-period key-metrics statement when you only need the company's latest standing.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
Example Response
Get Financial Ratios (TTM)
Retrieve a single trailing-twelve-month snapshot of profitability, liquidity, leverage, and per-share ratios. Ideal for "what is this company's current P/E / margins / ROE" questions.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
Example Response
Get Revenue Product Segmentation
Retrieve per-period revenue segmented by product/service line. The `data` object is keyed dynamically by product line.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" |
Example Response
Get Revenue Geographic Segmentation
Retrieve per-period revenue segmented by geographic region. The `data` object is keyed dynamically by region.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" |
Example Response
Error Handling
Always check the success property before accessing data:
Data Availability
Financial statement data availability depends on:
- Company filing schedule - Quarterly and annual reports
- Data processing time - FMP processes filings after SEC release
- Subscription tier - Some data may require premium plans
Next Steps
Explore other endpoint categories:
- Stock Endpoints - Real-time and historical stock data
- Examples - Practical code samples
Ready to explore stock data? Check out the Stock Endpoints for real-time quotes and market information.
Documentation
Quotes
Analysis
Information
Resources
Financial Endpoints
The Financial Endpoints provide access to financial statements, ratios, and fundamental data for companies.
Available Methods
| Method | Endpoint | Description |
|---|---|---|
| GET | /stable/income-statement?symbol={symbol} | Get income statement data |
| GET | /stable/balance-sheet-statement?symbol={symbol} | Get balance sheet data |
| GET | /stable/cash-flow-statement?symbol={symbol} | Get cash flow statement data |
| GET | /stable/key-metrics?symbol={symbol} | Get key financial metrics |
| GET | /stable/ratios?symbol={symbol} | Get financial ratios |
| GET | /stable/enterprise-values?symbol={symbol} | Get enterprise value data |
| GET | /stable/cash-flow-statement-growth?symbol={symbol} | Get cash flow growth metrics |
| GET | /stable/income-statement-growth?symbol={symbol} | Get income statement growth metrics |
| GET | /stable/balance-sheet-statement-growth?symbol={symbol} | Get balance sheet growth metrics |
| GET | /stable/financial-growth?symbol={symbol} | Get general financial growth metrics |
| GET | /stable/earnings?symbol={symbol} | Get historical earnings data |
| GET | /earnings-surprises/{symbol} | Get earnings surprises data |
| GET | /stable/financial-scores?symbol={symbol} | Get financial health scores (Altman Z + Piotroski) |
| GET | /stable/key-metrics-ttm?symbol={symbol} | Get trailing-twelve-month (TTM) key metrics |
| GET | /stable/ratios-ttm?symbol={symbol} | Get trailing-twelve-month (TTM) financial ratios |
| GET | /stable/revenue-product-segmentation?symbol={symbol} | Get revenue broken down by product line |
| GET | /stable/revenue-geographic-segmentation?symbol={symbol} | Get revenue broken down by geographic region |
Get Income Statement
Retrieve income statement data including revenue, expenses, and profit metrics.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" (default: "annual") |
| limit | number | No | Number of periods to retrieve (default: 5) |
Example Response
Get Balance Sheet
Retrieve balance sheet data including assets, liabilities, and equity.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" (default: "annual") |
| limit | number | No | Number of periods to retrieve (default: 5) |
Example Response
Get Cash Flow Statement
Retrieve cash flow statement data including operating, investing, and financing activities.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" (default: "annual") |
| limit | number | No | Number of periods to retrieve (default: 5) |
Example Response
Get Financial Ratios
Retrieve key financial ratios and metrics for analysis.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" (default: "annual") |
| limit | number | No | Number of periods to retrieve (default: 5) |
Example Response
Get Key Metrics
Retrieve key financial metrics including valuation ratios, profitability metrics, and efficiency ratios.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" (default: "annual") |
| limit | number | No | Number of periods to retrieve (default: 5) |
Example Response
Get Enterprise Value
Retrieve enterprise value data including market capitalization, debt, and cash calculations.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" (default: "annual") |
| limit | number | No | Number of periods to retrieve (default: 5) |
Example Response
Get Cashflow Growth
Retrieve cash flow growth metrics showing period-over-period changes in cash flow components.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" (default: "annual") |
| limit | number | No | Number of periods to retrieve (default: 5) |
Example Response
Get Income Growth
Retrieve income statement growth metrics showing period-over-period changes in revenue, expenses, and profitability.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" (default: "annual") |
| limit | number | No | Number of periods to retrieve (default: 5) |
Example Response
Get Balance Sheet Growth
Retrieve balance sheet growth metrics showing period-over-period changes in assets, liabilities, and equity.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" (default: "annual") |
| limit | number | No | Number of periods to retrieve (default: 5) |
Example Response
Get Financial Growth
Retrieve comprehensive financial growth metrics including revenue, earnings, and cash flow growth over multiple time periods.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" (default: "annual") |
| limit | number | No | Number of periods to retrieve (default: 5) |
Example Response
Get Earnings Historical
Retrieve historical and upcoming earnings announcements for a specific company, including estimated and actual earnings per share (EPS) and revenue data.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| limit | number | No | Number of earnings announcements to retrieve (default: 5) |
Example Response
Get Earnings Surprises
Retrieve earnings surprises data showing the difference between estimated and actual earnings per share (EPS) for companies.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
Example Response
Get Financial Scores
Retrieve financial health scores for a company: the Altman Z-Score (bankruptcy-risk indicator) and the Piotroski Score (fundamental-strength score, 0-9), plus the underlying components. Returns a single snapshot object.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
Example Response
Get Key Metrics (TTM)
Retrieve a single trailing-twelve-month snapshot of key valuation and performance metrics (EV multiples, returns, per-share figures). More token-efficient than the multi-period key-metrics statement when you only need the company's latest standing.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
Example Response
Get Financial Ratios (TTM)
Retrieve a single trailing-twelve-month snapshot of profitability, liquidity, leverage, and per-share ratios. Ideal for "what is this company's current P/E / margins / ROE" questions.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
Example Response
Get Revenue Product Segmentation
Retrieve per-period revenue segmented by product/service line. The `data` object is keyed dynamically by product line.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" |
Example Response
Get Revenue Geographic Segmentation
Retrieve per-period revenue segmented by geographic region. The `data` object is keyed dynamically by region.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol |
| period | string | No | Period type: "annual" or "quarter" |
Example Response
Error Handling
Always check the success property before accessing data:
Data Availability
Financial statement data availability depends on:
- Company filing schedule - Quarterly and annual reports
- Data processing time - FMP processes filings after SEC release
- Subscription tier - Some data may require premium plans
Next Steps
Explore other endpoint categories:
- Stock Endpoints - Real-time and historical stock data
- Examples - Practical code samples
Ready to explore stock data? Check out the Stock Endpoints for real-time quotes and market information.