# Cash flow (High demand)

The cash flow endpoint provides detailed information on a company&#039;s cash flow activities, including the net cash and cash equivalents moving in and out of the business. This data includes operating, investing, and financing cash flows, offering a comprehensive view of the company&#039;s liquidity and financial health.

**API credits cost:** `100` per symbol

> **Note:** This API endpoint is available on the <a href="https://twelvedata.com/pricing">Pro</a> plan (individual) and the <a href="https://twelvedata.com/pricing-business">Venture</a> plan (business) and above. Full access to historical data requires the <a href="https://twelvedata.com/pricing">Ultra</a> plan (individual) or the <a href="https://twelvedata.com/pricing-business">Enterprise</a> plan (business).

## Parameters

- `symbol` (string, optional, see notes)
  Symbol ticker of instrument.
For preferred stocks use dot(.) delimiter.
E.g. `BRK.A` or `BRK.B` will be correct
  Example value: `AAPL`


- `figi` (string, optional, see notes)
  Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
  Example value: `BBG000B9Y5X2`


- `isin` (string, optional, see notes)
  Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section
  Example value: `US0378331005`


- `cusip` (string, optional, see notes)
  The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section
  Example value: `594918104`


- `exchange` (string, optional)
  Exchange where instrument is traded
  Example value: `NASDAQ`


- `mic_code` (string, optional)
  Market Identifier Code (MIC) under ISO 10383 standard
  Example value: `XNAS`


- `country` (string, optional)
  Country where instrument is traded, e.g., `United States` or `US`
  Example value: `United States`


- `period` (string, optional)
  The reporting period for the cash flow statements
  Available values: `annual`, `quarterly`
  Default value: `annual`


- `start_date` (string, optional)
  Start date for filtering cash flow statements.
Only cash flow statements with fiscal dates on or after this date will be included.
Format `2006-01-02`
  Example value: `2024-01-01`


- `end_date` (string, optional)
  End date for filtering cash flow statements.
Only cash flow statements with fiscal dates on or before this date will be included.
Format `2006-01-02`
  Example value: `2024-12-31`


- `outputsize` (integer, optional)
  Number of records in response
  Default value: `6`


**Notes:**

 - At least one of the following parameters is required: `symbol`, `figi`, `isin`, `cusip`.

## Response

- `meta` (object)
  Meta information about the response
  - `symbol` (string)
    Symbol ticker of instrument
  - `name` (string)
    Name of the company
  - `currency` (string)
    Currency of the cash flow data according to the ISO 4217 standard
  - `exchange` (string)
    Exchange where instrument is traded
  - `mic_code` (string)
    Market identifier code (MIC) under ISO 10383 standard
  - `exchange_timezone` (string)
    Exchange timezone
  - `period` (string)
    Period of the cash flow data (Annual or Quarterly)

- `cash_flow` (array of object)
  Cash flow data
  - `fiscal_date` (string)
    Date of fiscal period ending
  - `quarter` (string)
    Fiscal quarter. Visible when `&period=quarterly`
  - `year` (integer)
    Fiscal year
  - `operating_activities` (object)
    Operating activities section
    - `net_income` (number)
      Returns net income (NI). Calculated as sales minus cost of goods sold
    - `depreciation` (number)
      Represents depreciation and amortization measure
    - `deferred_taxes` (number)
      Stands for taxes that are owed but are not due to be paid until a future date
    - `stock_based_compensation` (number)
      Refers to share-based compensation as the way of paying employees, executives, and directors of a company with equity in the business
    - `other_non_cash_items` (number)
      Represents other non-cash items
    - `accounts_receivable` (number)
      Represents the balance of money due to a firm for goods or services delivered or used but not yet paid for by customers
    - `accounts_payable` (number)
      Refers to an account within the general ledger that represents an obligation to pay off a short-term debt to creditors or suppliers
    - `other_assets_liabilities` (number)
      Represents cumulative changes in inventory, other current assets, other current liabilities, and other working capital
    - `operating_cash_flow` (number)
      Returns operating cash flow (OCF) measure representing a total amount of cash generated by company's normal business operations
  - `investing_activities` (object)
    Investing activities section
    - `capital_expenditures` (number)
      Capital expenditures (CapEx) are funds used by a company to acquire, upgrade, and maintain physical assets (PPE)
    - `net_intangibles` (number)
      Represents purchase of a not physical asset
    - `net_acquisitions` (number)
      Refers to net amount of business purchase and sale
    - `purchase_of_investments` (number)
      Represents how much money has been used in making investments, including purchases of physical assets, investments in securities
    - `sale_of_investments` (number)
      Represents how much money has been generated from the sale of securities or assets
    - `other_investing_activity` (number)
      Represents other investing activity
    - `investing_cash_flow` (number)
      Returns total amount of cash flow used in investments
  - `financing_activities` (object)
    Financing activities section
    - `long_term_debt_issuance` (number)
      Refers to the issuance of any financial obligations that extend beyond a 12 months period
    - `long_term_debt_payments` (number)
      Refers to the payments of any financial obligations that extend beyond a 12 months period
    - `short_term_debt_issuance` (number)
      Refers to the issuance of any financial obligations that are expected to be paid off within a year
    - `common_stock_issuance` (number)
      Represents a transaction whereby a company issues its own shares to the marketplace
    - `common_stock_repurchase` (number)
      Represents a transaction whereby a company buys back its own shares from the marketplace
    - `common_dividends` (number)
      Returns value of payment doled out by a company to its stockholders in the form of periodic distributions of cash
    - `other_financing_charges` (number)
      Represents other financing charges
    - `financing_cash_flow` (number)
      Returns cash flow from financing activities (CFF), which shows the net flows of cash that are used to fund the company
  - `end_cash_position` (number)
    Returns the amount of cash a company has when adding the change in cash and beginning cash balance for the current fiscal period
  - `income_tax_paid` (number)
    Refers to supplemental data about income tax paid
  - `interest_paid` (number)
    Refers to supplemental data about interest paid
  - `free_cash_flow` (number)
    Represents the cash a company generates after accounting for cash outflows to support operations and maintain its capital assets


## Example Request

```bash
curl "https://api.twelvedata.com/cash_flow?symbol=AAPL&apikey=demo"
```

## Example Response

```json
{
    "meta": {
        "symbol": "AAPL",
        "name": "Apple Inc",
        "currency": "USD",
        "exchange": "NASDAQ",
        "mic_code": "XNAS",
        "exchange_timezone": "America/New_York",
        "period": "Quarterly"
    },
    "cash_flow": [
        {
            "fiscal_date": "2021-12-31",
            "quarter": "1",
            "year": 2022,
            "operating_activities": {
                "net_income": 34630000000,
                "depreciation": 2697000000,
                "deferred_taxes": 682000000,
                "stock_based_compensation": 2265000000,
                "other_non_cash_items": 167000000,
                "accounts_receivable": -13746000000,
                "accounts_payable": 19813000000,
                "other_assets_liabilities": 458000000,
                "operating_cash_flow": 46966000000
            },
            "investing_activities": {
                "capital_expenditures": -2803000000,
                "net_intangibles": 0,
                "net_acquisitions": 0,
                "purchase_of_investments": -34913000000,
                "sale_of_investments": 21984000000,
                "other_investing_activity": -374000000,
                "investing_cash_flow": -16106000000
            },
            "financing_activities": {
                "long_term_debt_issuance": 0,
                "long_term_debt_payments": 0,
                "short_term_debt_issuance": -1000000000,
                "common_stock_issuance": 0,
                "common_stock_repurchase": -20478000000,
                "common_dividends": -3732000000,
                "other_financing_charges": -2949000000,
                "financing_cash_flow": -28159000000
            },
            "end_cash_position": 38630000000,
            "income_tax_paid": 5235000000,
            "interest_paid": 531000000,
            "free_cash_flow": 49769000000
        }
    ]
}
```
