Growth

Retrieve annualized revenue, EPS, free cash flow, per-share book value, share-count, and dividend growth for a symbol.

Use this endpoint when you want growth metrics that are already normalized for research, screening, or AI-agent comparisons.

Endpoint

GET /stocks/{symbol}/growth
Test request
/stocks/AAPL/growth

You can inspect the health endpoint without a key, but most endpoints require one. Create a free account to run the full workflow.

Send a request to view the response.

Authentication

Required.

Authorization: Bearer <your_api_key>

Path Parameters

  • symbol: ticker or symbol to resolve

What The Endpoint Is Good For

Use growth when you need to:

  • compare topline and EPS compounding across stocks
  • inspect free-cash-flow and per-share growth without rebuilding annual history
  • check whether buybacks are actually shrinking share count
  • feed AI-agent prompts with ready-to-use compounding fields

Response

Returns:

  • metadata
  • growth

metadata includes:

  • symbol
  • as_of_date
  • period_type
  • currency
  • calculation_version

growth includes:

  • revenue_growth_1y
  • revenue_cagr_3y
  • revenue_cagr_5y
  • eps_growth_1y
  • eps_cagr_3y
  • eps_cagr_5y
  • fcf_growth_1y
  • fcf_cagr_3y
  • fcf_cagr_5y
  • book_value_per_share_growth_1y
  • book_value_per_share_cagr_3y
  • book_value_per_share_cagr_5y
  • share_count_growth_1y
  • share_count_growth_3y
  • share_count_growth_5y
  • dividend_growth_3y
  • dividend_growth_5y

Response Notes

  • V1 is annual-based and uses the latest imported annual financial history for compounding fields.
  • Dividend growth is currently sourced from imported profile growth data.
  • Some CAGR fields may be unavailable when the required start point is missing or non-positive.
  • share_count_growth_* helps distinguish operational growth from dilution or buybacks.

Common Workflow

  1. Resolve the symbol with Search if needed.
  2. Call growth for annual compounding fields.
  3. Call Fundamental Metrics for quality and leverage ratios.
  4. Use statement endpoints if you need to audit the raw annual periods behind the growth figures.

Example Request

curl -H "Authorization: Bearer $your_api_key" \
  "https://api.apifinance.ai/stocks/AAPL/growth"

Next step

Run this endpoint with your own API key

Use the playground to inspect the response first, then create a key and move into implementation once the payload fits your product.