Summarise transactions

Totals over the transactions /transactions lists, with the same filters, per period bucket and at most one more dimension.

The counting rules are fixed so the figures match ThinkOut: transfers between the workspace’s own accounts and transactions the user excluded are left out, and split transactions count through their pieces. /transactions lists every movement, so summing it gives a different figure.

Amounts convert to currency at the rate of each transaction’s own date. Buckets are calendar aligned and clipped to the window. totals covers the whole window.

Rows grouped by period alone also carry the period’s starting balance, transfers, excluded movements and final balance. Those four are null when group_by or direction is given.

Grouped rows are ordered by absolute net, largest first. A period keeps at most 50 groups; the rest fold into one row labelled other. Transactions with no counterparty or no label fall in a none row, and a transaction with several labels counts once per label. Here category_id also covers subcategories.

Filters combine with AND; a filter that takes a list combines its values with OR.

Inflows and outflows per month, with balances

GET /transactions/summary?from=2026-03-01&to=2026-04-30&interval=month

Outflows per counterparty per month

GET /transactions/summary?from=2026-07-01&to=2026-08-31&interval=month&group_by=counterparty&direction=outflow

Cash flow per month for one bank’s accounts

GET /transactions/summary?from=2026-03-01&to=2026-08-31&interval=month&bank_id=5d6e7f80-9a1b-4c2d-8e3f-4a5b6c7d8e9f

GET

transactions

summary

Summarise transactions

curl --request GET \
  --url https://api.thinkout.io/v1/transactions/summary \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.thinkout.io/v1/transactions/summary', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

using RestSharp;


var options = new RestClientOptions("https://api.thinkout.io/v1/transactions/summary");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);

{
  "object": "summary",
  "period": {
    "from": "2026-03-01",
    "to": "2026-04-30",
    "macro": null,
    "interval": "month"
  },
  "conversion": {
    "applied": true,
    "currency": "RON",
    "basis": "transaction_date"
  },
  "group_by": null,
  "has_data": true,
  "totals": {
    "currency": "RON",
    "inflow": "163900.00",
    "outflow": "-118420.75",
    "net": "45479.25",
    "count": 401
  },
  "data": [
    {
      "period_start": "2026-03-01",
      "period_end": "2026-03-31",
      "group": null,
      "currency": "RON",
      "inflow": "84200.00",
      "outflow": "-61350.25",
      "net": "22849.75",
      "count": 212,
      "starting_balance": "128400.10",
      "transfers": "0.00",
      "excluded": "-1500.00",
      "final_balance": "149749.85"
    },
    {
      "period_start": "2026-04-01",
      "period_end": "2026-04-30",
      "group": null,
      "currency": "RON",
      "inflow": "79700.00",
      "outflow": "-57070.50",
      "net": "22629.50",
      "count": 189,
      "starting_balance": "149749.85",
      "transfers": "0.00",
      "excluded": "0.00",
      "final_balance": "172379.35"
    }
  ]
}

Authorizations

Authorization

string

header

required

A workspace API key created in ThinkOut settings. One key reads one workspace.

Query Parameters

from

string<date>

required

First day of the window, inclusive.

string<date>

required

Last day of the window, inclusive.

interval

enum<string>

default:month

The period bucket rows are grouped into. A period bucket for report rows.

Available options:

day,

week,

month

group_by

enum<string>

A second dimension to group by, alongside the period bucket. Omit it for one row per period. A dimension to group report rows by, alongside the period bucket.

Available options:

category,

counterparty,

label,

account,

activity,

direction

currency

string

Currency to report in. Defaults to the workspace currency. An unknown code is rejected. ISO 4217 alphabetic currency code.

Pattern: ^[A-Z]{3}$

Example:

"RON"

bank_id

string<uuid>[]

Only rows on the accounts fed by these bank connections. Comma-separated for several.

account_id

string<uuid>[]

Only rows on these accounts. Comma-separated for several.

category_id

string<uuid>[]

Only rows in these categories. Comma-separated for several. On /transactions this also matches a split transaction whose pieces are in one of them. Subcategories are included only on the summaries.

label_id

string<uuid>[]

Only rows carrying at least one of these labels. Comma-separated for several.

counterparty_id

string<uuid>[]

Only rows attributed to these counterparties. Comma-separated for several.

direction

enum<string>

Whether money comes in or goes out. On a transaction or forecast it follows the sign of amount.

Available options:

inflow,

outflow

activity

enum<string>[]

Only rows whose category sits in these cash flow statement sections. Comma-separated for several.

Cash flow statement section the category belongs to.

Available options:

operating,

investing,

financing

Response

The summary.

object

string

required

Allowed value: "summary"

period

object

required

The window actually computed.

Show child attributes

conversion

object

required

What was done to make amounts comparable.

Show child attributes

group_by

enum<string> | null

required

A dimension to group report rows by, alongside the period bucket.

Available options:

category,

counterparty,

label,

account,

activity,

direction

has_data

boolean

required

false when no transaction matched, as opposed to totals that came to zero.

totals

object

required

The whole window added up, after the same exclusions as the rows.

Show child attributes

data

object[]

required

Show child attributes

Summarise transactions

curl --request GET \
  --url https://api.thinkout.io/v1/transactions/summary \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.thinkout.io/v1/transactions/summary', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

using RestSharp;


var options = new RestClientOptions("https://api.thinkout.io/v1/transactions/summary");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);

{
  "object": "summary",
  "period": {
    "from": "2026-03-01",
    "to": "2026-04-30",
    "macro": null,
    "interval": "month"
  },
  "conversion": {
    "applied": true,
    "currency": "RON",
    "basis": "transaction_date"
  },
  "group_by": null,
  "has_data": true,
  "totals": {
    "currency": "RON",
    "inflow": "163900.00",
    "outflow": "-118420.75",
    "net": "45479.25",
    "count": 401
  },
  "data": [
    {
      "period_start": "2026-03-01",
      "period_end": "2026-03-31",
      "group": null,
      "currency": "RON",
      "inflow": "84200.00",
      "outflow": "-61350.25",
      "net": "22849.75",
      "count": 212,
      "starting_balance": "128400.10",
      "transfers": "0.00",
      "excluded": "-1500.00",
      "final_balance": "149749.85"
    },
    {
      "period_start": "2026-04-01",
      "period_end": "2026-04-30",
      "group": null,
      "currency": "RON",
      "inflow": "79700.00",
      "outflow": "-57070.50",
      "net": "22629.50",
      "count": 189,
      "starting_balance": "149749.85",
      "transfers": "0.00",
      "excluded": "0.00",
      "final_balance": "172379.35"
    }
  ]
}

Getting started

MCP

REST API

API reference

Summarise transactions

Authorizations

Query Parameters

Response