Reports

Retrieve cash flow statement

Returns the cash flow statement for the given date range. Defaults to the current quarter to date in America/Los_Angeles (Pacific Time). Both calendar-date boundaries are inclusive and honored exactly; response dates identify the period actually used.

Whole months read whole-month rollups. The current month’s first day through today in Pacific Time uses fresh MTD rollups, keeping month-aligned month-to-date and year-to-date requests fast. Other partial months, including a midmonth start, use slower raw-entry reads for only those months. Stale or unfilled MTD falls back to raw. This changes data sourcing and freshness, not the report’s numerical semantics.

refreshed_at covers the whole report, including its opening and closing balances: the maximum contributing rollup timestamp, including MTD, or current as of the call when any portion reads live raw entries, even when no raw entries match. Null when neither source supplies a timestamp.

The full statement is always returned. Returns one period per request. Make separate calls for monthly breakdowns.

Operating activities include presentation groupings that mirror the webapp display: “Changes in Working Capital” and “Non-Cash Expenses”. These are not database categories, so they use synthetic IDs prefixed with grp_ (e.g. grp_changes_in_working_capital, grp_non_cash_expenses). Their children reference them via parent_category_id. Category-level hierarchy within those groupings is also preserved: if a category has sub-categories, they appear with parent_category_id pointing to the parent, just like on the balance sheet and income statement.

GET

reports

cash_flow

Retrieve cash flow statement

curl --request GET \
  --url https://app.finta.com/api/v1/reports/cash_flow \
  --header 'Authorization: Bearer <token>'

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

fetch('https://app.finta.com/api/v1/reports/cash_flow', 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://app.finta.com/api/v1/reports/cash_flow",
  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://app.finta.com/api/v1/reports/cash_flow"

	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://app.finta.com/api/v1/reports/cash_flow")

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

{
  "object": "cash_flow",
  "start_date": "2026-02-01",
  "end_date": "2026-02-28",
  "currency": "USD",
  "refreshed_at": 1772323200,
  "operating_activities": {
    "total_cents": 2890000,
    "categories": [
      {
        "category_id": null,
        "name": "Net Income / (Loss)",
        "amount_cents": 3325000,
        "position": 1,
        "parent_category_id": null
      },
      {
        "category_id": "grp_changes_in_working_capital",
        "name": "Changes in Working Capital",
        "amount_cents": -450000,
        "position": 2,
        "parent_category_id": null
      },
      {
        "category_id": "cat_d3m4n5o6p7q8r9",
        "name": "Accounts Receivable",
        "amount_cents": -500000,
        "position": 3,
        "parent_category_id": "grp_changes_in_working_capital"
      },
      {
        "category_id": "cat_e4n5o6p7q8r9s0",
        "name": "Prepaid Expenses",
        "amount_cents": 50000,
        "position": 4,
        "parent_category_id": "grp_changes_in_working_capital"
      },
      {
        "category_id": "cat_h7q8r9s0t1u2v3",
        "name": "Credit Cards",
        "amount_cents": -100000,
        "position": 5,
        "parent_category_id": "grp_changes_in_working_capital"
      },
      {
        "category_id": "cat_q1unearned001",
        "name": "Unearned Revenue",
        "amount_cents": 10000,
        "position": 6,
        "parent_category_id": "grp_changes_in_working_capital"
      },
      {
        "category_id": "cat_i8r9s0t1u2v3w4",
        "name": "Accounts Payable",
        "amount_cents": 90000,
        "position": 7,
        "parent_category_id": "grp_changes_in_working_capital"
      },
      {
        "category_id": "grp_non_cash_expenses",
        "name": "Non-Cash Expenses",
        "amount_cents": 15000,
        "position": 8,
        "parent_category_id": null
      },
      {
        "category_id": "cat_a0j1k2l3m4n5o6",
        "name": "Amortization Expense",
        "amount_cents": 15000,
        "position": 9,
        "parent_category_id": "grp_non_cash_expenses"
      }
    ]
  },
  "investing_activities": {
    "total_cents": -200000,
    "categories": [
      {
        "category_id": "cat_f5o6p7q8r9s0t1",
        "name": "Security Deposit",
        "amount_cents": -200000,
        "position": 1,
        "parent_category_id": null
      }
    ]
  },
  "financing_activities": {
    "total_cents": 0,
    "categories": []
  },
  "beginning_cash_cents": 7110000,
  "ending_cash_cents": 9800000,
  "change_in_cash_cents": 2690000
}

Authorizations

Authorization

string

header

required

API key prefixed with finta_

Query Parameters

start_date

string<date>

Exact first included calendar date (YYYY-MM-DD) in Pacific Time. Defaults to the beginning of the current quarter. A midmonth start uses slower raw entries for that partial month.

end_date

string<date>

Exact last included calendar date (YYYY-MM-DD) in Pacific Time. Defaults to today. Month-start through today uses fresh MTD rollups; other partial-month boundaries use slower raw entries.

Response

The cash flow statement

object

enum<string>

required

Available options:

cash_flow

start_date

string<date>

required

The actual inclusive first calendar date used for this report in Pacific Time.

Example:

"2026-01-01"

end_date

string<date>

required

The actual inclusive last calendar date used for this report in Pacific Time.

Example:

"2026-03-31"

currency

string

required

Example:

"USD"

refreshed_at

integer | null

required

Unix timestamp covering the entire report, including partial months and opening and closing balances. For rollup-only reads, the maximum contributing rollup timestamp including MTD. Any live raw-entry portion is current as of the call, even with no matching raw entries. Null only when no contributing timestamp or live raw read is available.

Example:

1772323200

operating_activities

object

required

Show child attributes

investing_activities

object

required

Show child attributes

financing_activities

object

required

Show child attributes

beginning_cash_cents

integer

required

Cash balance in cents at the start of the period.

Example:

10000000

ending_cash_cents

integer

required

Cash balance in cents at the end of the period.

Example:

14500000

change_in_cash_cents

integer

required

Net change in cash for the period. Equals ending_cash_cents - beginning_cash_cents.

Example:

4500000

Retrieve cash flow statement

curl --request GET \
  --url https://app.finta.com/api/v1/reports/cash_flow \
  --header 'Authorization: Bearer <token>'

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

fetch('https://app.finta.com/api/v1/reports/cash_flow', 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://app.finta.com/api/v1/reports/cash_flow",
  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://app.finta.com/api/v1/reports/cash_flow"

	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://app.finta.com/api/v1/reports/cash_flow")

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

{
  "object": "cash_flow",
  "start_date": "2026-02-01",
  "end_date": "2026-02-28",
  "currency": "USD",
  "refreshed_at": 1772323200,
  "operating_activities": {
    "total_cents": 2890000,
    "categories": [
      {
        "category_id": null,
        "name": "Net Income / (Loss)",
        "amount_cents": 3325000,
        "position": 1,
        "parent_category_id": null
      },
      {
        "category_id": "grp_changes_in_working_capital",
        "name": "Changes in Working Capital",
        "amount_cents": -450000,
        "position": 2,
        "parent_category_id": null
      },
      {
        "category_id": "cat_d3m4n5o6p7q8r9",
        "name": "Accounts Receivable",
        "amount_cents": -500000,
        "position": 3,
        "parent_category_id": "grp_changes_in_working_capital"
      },
      {
        "category_id": "cat_e4n5o6p7q8r9s0",
        "name": "Prepaid Expenses",
        "amount_cents": 50000,
        "position": 4,
        "parent_category_id": "grp_changes_in_working_capital"
      },
      {
        "category_id": "cat_h7q8r9s0t1u2v3",
        "name": "Credit Cards",
        "amount_cents": -100000,
        "position": 5,
        "parent_category_id": "grp_changes_in_working_capital"
      },
      {
        "category_id": "cat_q1unearned001",
        "name": "Unearned Revenue",
        "amount_cents": 10000,
        "position": 6,
        "parent_category_id": "grp_changes_in_working_capital"
      },
      {
        "category_id": "cat_i8r9s0t1u2v3w4",
        "name": "Accounts Payable",
        "amount_cents": 90000,
        "position": 7,
        "parent_category_id": "grp_changes_in_working_capital"
      },
      {
        "category_id": "grp_non_cash_expenses",
        "name": "Non-Cash Expenses",
        "amount_cents": 15000,
        "position": 8,
        "parent_category_id": null
      },
      {
        "category_id": "cat_a0j1k2l3m4n5o6",
        "name": "Amortization Expense",
        "amount_cents": 15000,
        "position": 9,
        "parent_category_id": "grp_non_cash_expenses"
      }
    ]
  },
  "investing_activities": {
    "total_cents": -200000,
    "categories": [
      {
        "category_id": "cat_f5o6p7q8r9s0t1",
        "name": "Security Deposit",
        "amount_cents": -200000,
        "position": 1,
        "parent_category_id": null
      }
    ]
  },
  "financing_activities": {
    "total_cents": 0,
    "categories": []
  },
  "beginning_cash_cents": 7110000,
  "ending_cash_cents": 9800000,
  "change_in_cash_cents": 2690000
}

API Reference

Onboarding

Sheets

Taxes

Files

Company

Plans & billing

Team

Categories

Rules

Tags

Departments

Integrations

Inbox

Aggregations

Transactions

Forms

Reconciliation

Journal Entries

Invoices

Parties

Metrics

Reports

Feedback

Tax Credits

Retrieve cash flow statement

Authorizations

Query Parameters

Response