Skip to main content
GET
/
v1
/
cash-flow
Cash Flow Statement
curl --request GET \
  --url https://api.chicago.global/v1/cash-flow \
  --header 'Authorization: Bearer <token>'
[
  {
    "ric": "<string>",
    "perenddt": "2023-12-25",
    "stmtdt": "2023-12-25",
    "sourcedt": "2023-12-25",
    "pertypecode": 123,
    "currency": "<string>",
    "unitsconvtocode": "<string>",
    "net_income_starting_line": 123,
    "depreciation_depletion": 123,
    "non_cash_items": 123,
    "changes_in_working_capital": 123,
    "cash_from_operating_activities": 123,
    "capital_expenditures": 123,
    "cash_from_investing_activities": 123,
    "total_cash_dividends_paid": 123,
    "issuance_retirement_of_stock_net": 123,
    "issuance_retirement_of_debt_net": 123,
    "cash_from_financing_activities": 123,
    "net_change_in_cash": 123,
    "net_cash_beginning_balance": 123,
    "net_cash_ending_balance": 123
  }
]
Retrieve cash flow statement data for a given stock symbol. Returns operating, investing, and financing cash flows sourced from LSEG Datastream.

​
Query Parameters

ParameterTypeRequiredDefaultDescription
symbolstringYes—Stock symbol (e.g., AAPL.O, 0700.HK). Ticker shorthand like AAPL is also accepted and will be resolved automatically.
limitintegerNo4Number of periods to return
freqintegerNo11 for Annual, 2 for Quarterly

​
Response

Returns an array of period objects with the full cash flow breakdown: 
[
  {
    "ric": "AAPL.O",
    "perenddt": "2025-09-27",
    "stmtdt": "2025-09-27",
    "sourcedt": "2025-10-31",
    "pertypecode": 1,
    "currency": "USD",
    "unitsconvtocode": "M",
    "net_income_starting_line": 112010000000,
    "depreciation_depletion": 11698000000,
    "amortization": null,
    "deferred_taxes": null,
    "non_cash_items": 12774000000,
    "changes_in_working_capital": -25000000000,
    "accounts_receivable_change": -7029000000,
    "inventories_change": 1400000000,
    "other_assets_change": -9197000000,
    "accounts_payable_change": 902000000,
    "other_liabilities_change": -11076000000,
    "cash_from_operating_activities": 111482000000,
    "capital_expenditures": -12715000000,
    "other_investing_cash_flow_items_total": 27910000000,
    "cash_from_investing_activities": 15195000000,
    "financing_cash_flow_items": -6071000000,
    "total_cash_dividends_paid": -15421000000,
    "issuance_retirement_of_stock_net": -90711000000,
    "issuance_retirement_of_debt_net": -8483000000,
    "cash_from_financing_activities": -120686000000,
    "foreign_exchange_effects": null,
    "net_change_in_cash": 5991000000,
    "net_cash_beginning_balance": 29943000000,
    "net_cash_ending_balance": 35934000000,
    "cash_interest_paid": null,
    "cash_taxes_paid": 43369000000
  }
]
All monetary values are in the company’s reporting currency. The currency field indicates which currency. Negative values indicate cash outflows. Fields with null values are not applicable for the given company.

​
Key Fields

FieldDescription
perenddtPeriod end date
pertypecode1 for Annual, 2 for Quarterly
net_income_starting_lineNet income used as starting point
depreciation_depletionDepreciation and depletion add-back
changes_in_working_capitalNet change in working capital
cash_from_operating_activitiesCash generated from core business operations
capital_expendituresSpending on property, plant, and equipment
cash_from_investing_activitiesNet cash from investment activities
cash_from_financing_activitiesNet cash from debt and equity transactions
net_change_in_cashTotal change in cash for the period
net_cash_beginning_balanceCash balance at start of period
net_cash_ending_balanceCash balance at end of period

​
Example

curl "https://api.chicago.global/v1/cash-flow?symbol=AAPL.O&limit=4&freq=1" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch(
  'https://api.chicago.global/v1/cash-flow?symbol=AAPL.O&limit=4&freq=1',
  { headers: { 'Authorization': `Bearer ${API_KEY}` } }
);

const periods = await response.json();
const fcf = periods[0].cash_from_operating_activities + periods[0].capital_expenditures;
console.log(`Free Cash Flow: ${fcf}`);

Authorizations

​
Authorization
string
header
required

API key passed as Bearer token

Query Parameters

​
symbol
string
required

Stock symbol (e.g., AAPL.O, 0700.HK). Ticker shorthand like AAPL is also accepted.

​
limit
integer
default:4

Number of periods to return

​
freq
enum<integer>
default:1

1 for Annual, 2 for Quarterly

Available options:
1,
2

Response

Cash flow data retrieved successfully

​
ric
string

Reuters Instrument Code

​
perenddt
string<date>

Period end date

​
stmtdt
string<date>
​
sourcedt
string<date>
​
pertypecode
integer

1 for Annual, 2 for Quarterly

​
currency
string

Reporting currency

​
unitsconvtocode
string

Unit scale (e.g., M for millions)

​
net_income_starting_line
number | null

Net income used as starting point

​
depreciation_depletion
number | null
​
non_cash_items
number | null
​
changes_in_working_capital
number | null
​
cash_from_operating_activities
number | null

Cash from core business operations

​
capital_expenditures
number | null

Spending on PP&E

​
cash_from_investing_activities
number | null

Net cash from investment activities

​
total_cash_dividends_paid
number | null
​
issuance_retirement_of_stock_net
number | null
​
issuance_retirement_of_debt_net
number | null
​
cash_from_financing_activities
number | null

Net cash from debt and equity transactions

​
net_change_in_cash
number | null

Total change in cash for the period

​
net_cash_beginning_balance
number | null
​
net_cash_ending_balance
number | null