Cash Flow Statements

Python (SDK)

from finance_dev import FinanceDev, models


with FinanceDev(
    security=models.Security(
        client_id="<YOUR_CLIENT_ID_HERE>",
        client_secret="<YOUR_CLIENT_SECRET_HERE>",
    ),
) as fd_client:

    res = fd_client.financials.get_cash_flow_statements()

    while res is not None:
        # Handle items

        res = res.next()

import { FinanceDev } from "@ariesdotcom/finance-dev";

const financeDev = new FinanceDev({
  security: {
    clientID: "<YOUR_CLIENT_ID_HERE>",
    clientSecret: "<YOUR_CLIENT_SECRET_HERE>",
  },
});

async function run() {
  const result = await financeDev.financials.cashFlowStatements.get();

  for await (const page of result) {
    console.log(page);
  }
}

run();

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aries.com/v1/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://api.aries.com/v1/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 => [
    "Authorization: Bearer <token>"
  ],
]);

$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://api.aries.com/v1/financials/cash-flow-statements"

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

	req.Header.Add("Authorization", "Bearer <token>")

	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://api.aries.com/v1/financials/cash-flow-statements")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "nextUrl": "https://api.aries.com/v1/financials/cash-flow-statements?limit=5&next=ASYPBEFBUEwCAgABAQABAQUAAgEJ-zp0AQ8KMDAwMDMyMDE5Mw%3D%3D&tickersAnyOf=AAPL",
  "requestId": "d9ebd27856db41dc8f24f8118f9cada0",
  "results": [
    {
      "cashFromOperatingActivitiesContinuingOperations": 5781000000,
      "changeInCashAndEquivalents": 2346000000,
      "changeInOtherOperatingAssetsAndLiabilitiesNet": 1564000000,
      "cik": "0000320193",
      "depreciationDepletionAndAmortization": 209000000,
      "dividends": 0,
      "filingDate": "2011-01-19",
      "fiscalQuarter": 1,
      "fiscalYear": 2010,
      "longTermDebtIssuancesRepayments": 0,
      "netCashFromFinancingActivities": 523000000,
      "netCashFromFinancingActivitiesContinuingOperations": 523000000,
      "netCashFromInvestingActivities": -3958000000,
      "netCashFromInvestingActivitiesContinuingOperations": -3958000000,
      "netCashFromOperatingActivities": 5781000000,
      "netIncome": 3378000000,
      "otherFinancingActivities": 523000000,
      "otherInvestingActivities": -3582000000,
      "otherOperatingActivities": 630000000,
      "periodEnd": "2009-12-26",
      "purchaseOfPropertyPlantAndEquipment": -376000000,
      "tickers": [
        "AAPL"
      ],
      "timeframe": "quarterly"
    }
  ],
  "status": "OK"
}

GET

financials

cash-flow-statements

Python (SDK)

from finance_dev import FinanceDev, models


with FinanceDev(
    security=models.Security(
        client_id="<YOUR_CLIENT_ID_HERE>",
        client_secret="<YOUR_CLIENT_SECRET_HERE>",
    ),
) as fd_client:

    res = fd_client.financials.get_cash_flow_statements()

    while res is not None:
        # Handle items

        res = res.next()

import { FinanceDev } from "@ariesdotcom/finance-dev";

const financeDev = new FinanceDev({
  security: {
    clientID: "<YOUR_CLIENT_ID_HERE>",
    clientSecret: "<YOUR_CLIENT_SECRET_HERE>",
  },
});

async function run() {
  const result = await financeDev.financials.cashFlowStatements.get();

  for await (const page of result) {
    console.log(page);
  }
}

run();

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aries.com/v1/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://api.aries.com/v1/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 => [
    "Authorization: Bearer <token>"
  ],
]);

$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://api.aries.com/v1/financials/cash-flow-statements"

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

	req.Header.Add("Authorization", "Bearer <token>")

	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://api.aries.com/v1/financials/cash-flow-statements")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "nextUrl": "https://api.aries.com/v1/financials/cash-flow-statements?limit=5&next=ASYPBEFBUEwCAgABAQABAQUAAgEJ-zp0AQ8KMDAwMDMyMDE5Mw%3D%3D&tickersAnyOf=AAPL",
  "requestId": "d9ebd27856db41dc8f24f8118f9cada0",
  "results": [
    {
      "cashFromOperatingActivitiesContinuingOperations": 5781000000,
      "changeInCashAndEquivalents": 2346000000,
      "changeInOtherOperatingAssetsAndLiabilitiesNet": 1564000000,
      "cik": "0000320193",
      "depreciationDepletionAndAmortization": 209000000,
      "dividends": 0,
      "filingDate": "2011-01-19",
      "fiscalQuarter": 1,
      "fiscalYear": 2010,
      "longTermDebtIssuancesRepayments": 0,
      "netCashFromFinancingActivities": 523000000,
      "netCashFromFinancingActivitiesContinuingOperations": 523000000,
      "netCashFromInvestingActivities": -3958000000,
      "netCashFromInvestingActivitiesContinuingOperations": -3958000000,
      "netCashFromOperatingActivities": 5781000000,
      "netIncome": 3378000000,
      "otherFinancingActivities": 523000000,
      "otherInvestingActivities": -3582000000,
      "otherOperatingActivities": 630000000,
      "periodEnd": "2009-12-26",
      "purchaseOfPropertyPlantAndEquipment": -376000000,
      "tickers": [
        "AAPL"
      ],
      "timeframe": "quarterly"
    }
  ],
  "status": "OK"
}

Authorizations

Authorization

string

header

required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Scopes

market:supplemental

News, company profiles, financials, filings, ETF data, technical analysis

Query Parameters

cik

string

Exact SEC CIK company identifier. Use this when you need one specific SEC registrant.

ciks

string

Comma-separated CIKs (maps to cik.any_of)

cikAfter

string

CIK pagination lower bound. Returns records with CIK values greater than this value, excluding the value itself.

cikFrom

string

CIK greater than or equal (inclusive)

cikBefore

string

CIK pagination upper bound. Returns records with CIK values less than this value, excluding the value itself.

cikTo

string

CIK upper-bound filter. Returns records with CIK values less than or equal to this value.

periodEnd

string<date>

Exact fiscal period-end date filter. Use it to return statements for one reporting period.

periodEndAfter

string<date>

Fiscal period-end lower-bound filter. Returns records after this date, excluding the date itself.

periodEndFrom

string<date>

Fiscal period-end start filter. Returns records on or after this date.

periodEndBefore

string<date>

Fiscal period-end upper-bound filter. Returns records before this date, excluding the date itself.

periodEndTo

string<date>

Fiscal period-end end filter. Returns records on or before this date.

filingDate

string<date>

Exact filing date filter. Use it to return filings submitted on one specific date.

filingDateAfter

string<date>

Filing-date lower-bound filter. Returns records after this date, excluding the date itself.

filingDateFrom

string<date>

Filing-date start filter. Returns records on or after this date.

filingDateBefore

string<date>

Filing-date upper-bound filter. Returns records before this date, excluding the date itself.

filingDateTo

string<date>

Filing-date end filter. Returns records on or before this date.

tickers

string

Ticker symbol filter. Enter a ticker such as AAPL to narrow results to one company.

tickersAllOf

string

Ticker all-of filter. Return records that include all listed tickers.

tickersAnyOf

string

Ticker any-of filter. Return records that include at least one listed ticker.

fiscalYear

number<double>

Exact fiscal year filter. Use it to return statements for one reporting year.

fiscalYearAbove

number<double>

Fiscal year greater than (exclusive)

fiscalYearMin

number<double>

Fiscal year greater than or equal (inclusive)

fiscalYearBelow

number<double>

Fiscal-year upper-bound filter. Returns records before this fiscal year, excluding the year itself.

fiscalYearMax

number<double>

Fiscal year less than or equal (inclusive)

fiscalQuarter

number<double>

Exact fiscal quarter filter. Use values such as 1, 2, 3, or 4 when supported.

fiscalQuarterAbove

number<double>

Fiscal quarter greater than (exclusive)

fiscalQuarterMin

number<double>

Fiscal quarter greater than or equal (inclusive)

fiscalQuarterBelow

number<double>

Fiscal quarter less than (exclusive)

fiscalQuarterMax

number<double>

Fiscal quarter less than or equal (inclusive)

timeframe

string

Reporting timeframe (e.g. quarterly, annual)

timeframeAnyOf

string

Timeframe any-of filter. Return records that match at least one listed timeframe.

timeframeAfter

string

Timeframe lower-bound filter. Returns records after this timeframe, excluding the value itself.

timeframeFrom

string

Timeframe greater than or equal (inclusive)

timeframeBefore

string

Timeframe upper-bound filter. Returns records before this timeframe, excluding the value itself.

timeframeTo

string

Timeframe less than or equal (inclusive)

maxTicker

string

Exact maximum ticker value from the statement record. Use only for provider-specific filtering.

maxTickerAnyOf

string

Max ticker any-of filter. Return records matching at least one listed maxTicker value.

maxTickerAfter

string

Max ticker greater than (exclusive)

maxTickerFrom

string

Max ticker greater than or equal (inclusive)

maxTickerBefore

string

Max ticker upper-bound filter. Returns records before this value, excluding the value itself.

maxTickerTo

string

Max ticker less than or equal (inclusive)

minTicker

string

Exact minimum ticker value from the statement record. Use only for provider-specific filtering.

minTickerAnyOf

string

Min ticker any-of filter. Return records matching at least one listed minTicker value.

minTickerAfter

string

Min ticker greater than (exclusive)

minTickerFrom

string

Min ticker greater than or equal (inclusive)

minTickerBefore

string

Min ticker upper-bound filter. Returns records before this value, excluding the value itself.

minTickerTo

string

Min ticker less than or equal (inclusive)

limit

integer

Maximum number of results per page. Use smaller values for UI pages and larger values for exports within API limits.

Required range: x >= 1

sort

string

A comma-separated list of sort columns. For each column, append .asc or .desc to specify direction. Defaults to period_end.asc when not specified.

string

Pagination cursor from the previous response. Omit it on the first request, then send the returned cursor to fetch the next page.

Response

Successful response with one or more SEC cash flow rows, status, request id, and optional nextUrl for pagination.

Paginated SEC cash flow statements (results, status, requestId, nextUrl).

nextUrl

string

URL for the next page when more results exist

requestId

string

Provider request identifier. Include this when reporting data issues to support.

results

object[]

Cash flow statement rows for the requested filters. Use these to analyze operating, investing, and financing cash flows.

Show child attributes

status

string

Status string from the upstream data provider — typically OK for a successful response. Treat any other value as an error indicator alongside the HTTP status code.

Analytics

Options

Stocks

Economy

Calendar

Market

Company

Ownership

Financials

Filings

Corporate Actions

Indices

Logos

Stock Estimates

Stock Alternative

News

ETF

Technical Analysis

Signals

Cash Flow Statements

Authorizations

Scopes

Query Parameters

Response