Cash Flow Statements

GET

financials

cash-flow-statements

Get cash flow statements

curl --request GET \
  --url https://financialdatasets.rip/financials/cash-flow-statements \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://financialdatasets.rip/financials/cash-flow-statements', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://financialdatasets.rip/financials/cash-flow-statements",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://financialdatasets.rip/financials/cash-flow-statements"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://financialdatasets.rip/financials/cash-flow-statements")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "cash_flow_statements": [
    {
      "ticker": "AAPL",
      "report_period": "2025-09-27",
      "fiscal_period": "FY2025",
      "period": "annual",
      "accession_number": "0000320193-25-000079",
      "form_type": "10-K",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019325000079/aapl-20250927.htm",
      "filing_date": "2025-10-31",
      "net_income": 112010000000,
      "depreciation_and_amortization": 11698000000,
      "net_cash_flow_from_operations": 111482000000,
      "capital_expenditure": 12715000000,
      "net_cash_flow_from_investing": 15195000000,
      "dividends_and_other_cash_distributions": 15421000000,
      "net_cash_flow_from_financing": -120686000000,
      "change_in_cash_and_equivalents": 5991000000,
      "free_cash_flow": 98767000000
    }
  ]
}

This route returns one cash flow statement row per reporting period: cash generated or consumed by operations, investing, and financing activities, plus the resulting change in cash. It shares its provider chain and pagination shape with Income Statements: the same /equities/v1/statements fetch, joined against /equities/v1/filings for SEC identity.

What this answers

How much cash a company generated from operations in a given period, and where it went.
What a company’s free cash flow was for a given fiscal year or quarter.

Coverage


Provider chain	DefiLlama `/equities/v1/statements`, joined with `/equities/v1/filings`
Reporting periods	Annual, quarterly, and trailing-twelve-month (`ttm`)
Measured cost	$0.0012 per call (statement fetch plus the filings identity join)
Cache TTL	600 seconds, see Caching

Query rules

ticker is required. period accepts annual, quarterly, or ttm, and defaults to annual on this REST route, unlike the underlying MCP tool’s own ttm default. Pass period explicitly if the default matters. as_reported=true is accepted for parameter parity but always answers 400 bad_request. limit defaults to 4 and caps at 100. The report_period* family of filters narrows by report date, the same way it does on Income Statements. Fields the current Go source declares but our own live captures never populate: currency, accession_number, form_type, filing_url, filing_date, filing_datetime, net_income, depreciation_and_amortization, share_based_compensation, capital_expenditure, business_acquisitions_and_disposals, investment_acquisitions_and_disposals, issuance_or_repayment_of_debt_securities, issuance_or_purchase_of_equity_shares, effect_of_exchange_rate_changes. These are schema-legal and left out of the response rather than guessed.

Worked example

curl

curl -s 'https://financialdatasets.rip/financials/cash-flow-statements?ticker=AAPL&period=annual&limit=1' \
  -H 'X-API-KEY: <your-api-key>'

Response

{
  "cash_flow_statements": [
    {
      "ticker": "AAPL",
      "report_period": "2025-09-27",
      "fiscal_period": "FY2025",
      "period": "annual",
      "accession_number": "0000320193-25-000079",
      "form_type": "10-K",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019325000079/aapl-20250927.htm",
      "filing_date": "2025-10-31",
      "net_income": 112010000000,
      "depreciation_and_amortization": 11698000000,
      "net_cash_flow_from_operations": 111482000000,
      "capital_expenditure": 12715000000,
      "net_cash_flow_from_investing": 15195000000,
      "dividends_and_other_cash_distributions": 15421000000,
      "net_cash_flow_from_financing": -120686000000,
      "change_in_cash_and_equivalents": 5991000000,
      "free_cash_flow": 98767000000
    }
  ]
}

Authorizations

X-API-KEY

string

header

required

The caller's own Monid API key (get one at https://monid.ai?fpr=dhruv-15136b). Passed straight through to Monid on every call, so usage bills the caller's own wallet — this is never a shared server-side credential, and the server never logs or stores it. Missing, empty, or malformed values answer 401 unauthorized before any paid call is attempted.

Query Parameters

ticker

string

required

Uppercase-normalized ticker symbol (1-20 letters/digits/dots/hyphens).

period

enum<string>

default:annual

Reporting period. REST-level default is "annual"; the tool/FD-schema default is "ttm".

Available options:

annual,

quarterly,

ttm

limit

integer

default:4

Number of records to retrieve (default: 4, max: 100).

Required range: 1 <= x <= 100

as_reported

boolean

default:false

Accepted for FD parameter parity but always rejected: as_reported=true answers 400 bad_request ("as_reported is not supported; use the normalized cash-flow-statements endpoint") at zero cost.

report_period

string<date>

Exact report_period date filter (YYYY-MM-DD).

report_period_gte

string<date>

report_period >= this date (YYYY-MM-DD, inclusive).

report_period_lte

string<date>

report_period <= this date (YYYY-MM-DD, inclusive).

report_period_gt

string<date>

report_period > this date (YYYY-MM-DD, exclusive).

report_period_lt

string<date>

report_period < this date (YYYY-MM-DD, exclusive).

cursor

string

Opaque base64url pagination cursor from a previous response's next_page_url. Omit for the first page.

Response

A page of cash flow statements, newest report_period first. Real AAPL FY2025 annual values captured from our own live API (docs/our-live-samples/cash_flow.json).

Wrapped list envelope: {"cash_flow_statements": [...], "next_page_url": "..."}. Page size is 10 records (100 for /prices).

cash_flow_statements

CashFlowStatement · object[]

required

Show child attributes

next_page_url

string<uri>

Absolute URL for the next page, present only when more records remain. Built from an opaque base64url cursor over this deployment's own host (never a fixed facade base).

Get cash flow statements

curl --request GET \
  --url https://financialdatasets.rip/financials/cash-flow-statements \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://financialdatasets.rip/financials/cash-flow-statements', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://financialdatasets.rip/financials/cash-flow-statements",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://financialdatasets.rip/financials/cash-flow-statements"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://financialdatasets.rip/financials/cash-flow-statements")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "cash_flow_statements": [
    {
      "ticker": "AAPL",
      "report_period": "2025-09-27",
      "fiscal_period": "FY2025",
      "period": "annual",
      "accession_number": "0000320193-25-000079",
      "form_type": "10-K",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019325000079/aapl-20250927.htm",
      "filing_date": "2025-10-31",
      "net_income": 112010000000,
      "depreciation_and_amortization": 11698000000,
      "net_cash_flow_from_operations": 111482000000,
      "capital_expenditure": 12715000000,
      "net_cash_flow_from_investing": 15195000000,
      "dividends_and_other_cash_distributions": 15421000000,
      "net_cash_flow_from_financing": -120686000000,
      "change_in_cash_and_equivalents": 5991000000,
      "free_cash_flow": 98767000000
    }
  ]
}

Overview

Integrations

Datasets

Guides

MCP Tools

What this answers

Coverage

Query rules

Worked example

Authorizations

Query Parameters

Response

​What this answers

​Coverage

​Query rules

​Worked example

Authorizations

Query Parameters

Response

What this answers

Coverage

Query rules

Worked example