Capital Allocation

Use this endpoint when you want to understand how management is deploying cash across buybacks, dividends, debt, capex, and acquisitions.

Endpoint

GET /stocks/{symbol}/capital-allocation

Authentication

Required.

Authorization: Bearer <your_api_key>

Path Parameters

• symbol: ticker or symbol to resolve

What The Endpoint Is Good For

Use capital-allocation when you need to:

• inspect whether free cash flow is being returned to shareholders or reinvested
• measure buybacks against dilution and share issuance
• track debt issuance versus debt repayment
• feed AI-agent research with clean capital-allocation fields from the latest annual period

Response

Returns:

• metadata
• capital_allocation

capital_allocation includes:

• operating_cash_flow
• capex
• free_cash_flow
• stock_based_compensation
• share_repurchases
• share_issuance
• net_buyback_amount
• dividends_paid
• acquisition_spend
• debt_issued
• debt_repaid
• net_debt_change
• share_count_diluted
• share_count_change_1y
• buyback_yield
• dividend_payout_ratio

Response Notes

• V1 uses the latest imported annual financial period.
• Outflow-style fields such as capex, share_repurchases, dividends_paid, debt_repaid, and acquisition_spend are returned as positive values for readability.
• share_count_change_1y is an absolute one-year change in diluted share count, not a percentage growth rate.
• buyback_yield uses the latest available market cap snapshot when quote data is present.

Common Workflow

1. Resolve the symbol with Search if needed.
2. Call capital-allocation for the latest annual deployment snapshot.
3. Call Growth to see whether capital allocation is producing per-share compounding.
4. Use raw cash flow statements if you need the full financing and investing line-item trail.

Example Request

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

Related Endpoints

• Growth
• Fundamental Metrics
• Cash flow statement