---
title: "Annual cash flow and capital allocation from XBRL facts"
method: GET
path: "/api/insights/{symbol}/cashflow"
tags: ["insights"]
---

# Annual cash flow and capital allocation from XBRL facts

`GET /api/insights/{symbol}/cashflow`

## Request

- Base URL: `https://api.halalterminal.com`
- URL: `https://api.halalterminal.com/api/insights/{symbol}/cashflow`
- Auth: API key in header `X-API-Key`

Per-fiscal-year cash flow and capital allocation from the SEC XBRL
company-facts cache: operating cash flow, capex, free cash flow, dividends,
buybacks, debt issued/repaid, acquisitions, plus stock-based compensation
and D&A. Annual only, so each figure ties to the audited 10-K.

Answers what a company earns in cash and what it does with it — e.g. Oracle
ran free cash flow negative funding a debt-financed capex build-out, while
Apple returns more than its free cash flow to shareholders.

## Path parameters

- `symbol` string, required: Ticker symbol, e.g. AAPL.

## Query parameters

- `years` integer: Number of recent fiscal years to return.

## Response `200`

Per-fiscal-year operating cash flow, capex, free cash flow, and capital-allocation flows

- object

## Other responses

- `401`: API key required or invalid
- `422`: Validation Error
- `429`: Quota exceeded

---

[API](https://skmtc.dev/halalterminal/apis/halal-terminal-api.md) · [All operations](https://skmtc.dev/halalterminal/apis/halal-terminal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/halalterminal/apis/halal-terminal-api/revisions/78768b250943?raw)