Sintetizează tranzacțiile

Totaluri peste tranzacțiile pe care le listează /transactions, cu aceleași filtre, pe interval de timp și cel mult încă o dimensiune.

Regulile de numărare sunt fixe, ca cifrele să coincidă cu ThinkOut: transferurile între conturile proprii ale spațiului de lucru și tranzacțiile excluse de utilizator sunt lăsate deoparte, iar tranzacțiile împărțite se numără prin bucățile lor. /transactions listează fiecare mișcare, așa că însumarea ei dă o cifră diferită.

Sumele se convertesc în currency la cursul din data fiecărei tranzacții. Intervalele sunt aliniate la calendar și tăiate la fereastra cerută. totals acoperă întreaga fereastră.

Rândurile grupate doar pe interval poartă și soldul de început, transferurile, mișcările excluse și soldul de final ale intervalului. Cele patru sunt null când este trimis group_by sau direction.

Rândurile grupate sunt ordonate după net în valoare absolută, cel mai mare primul. Un interval păstrează cel mult 50 de grupuri; restul se strâng într-un singur rând etichetat other. Tranzacțiile fără partener sau fără etichetă ajung într-un rând none, iar o tranzacție cu mai multe etichete se numără o dată pentru fiecare etichetă. Aici category_id acoperă și subcategoriile.

Filtrele se combină cu AND; un filtru care acceptă o listă își combină valorile cu OR.

Încasări și plăți pe luni, cu solduri

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

Plăți pe partener, pe luni

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

Cash flow pe luni pentru conturile unei bănci

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

GET

transactions

summary

Sintetizează tranzacțiile

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"
    }
  ]
}

Autorizări

Authorization

string

header

obligatoriu

O cheie API creată în setările ThinkOut. O cheie citește un singur spațiu de lucru.

Parametri interogare

from

string<date>

obligatoriu

Prima zi a ferestrei, inclusiv.

string<date>

obligatoriu

Ultima zi a ferestrei, inclusiv.

interval

enum<string>

implicit:month

Intervalul de timp în care sunt grupate rândurile. Intervalul de timp pentru rândurile unui raport.

Opțiuni disponibile:

day,

week,

month

group_by

enum<string>

O a doua dimensiune de grupare, pe lângă intervalul de timp. Omite-o pentru un singur rând per interval. O dimensiune după care se grupează rândurile raportului, pe lângă intervalul de timp.

Opțiuni disponibile:

category,

counterparty,

label,

account,

activity,

direction

currency

string

Moneda în care se raportează. Implicit moneda spațiului de lucru. Un cod necunoscut este respins. Cod de monedă alfabetic ISO 4217.

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

Exemplu:

"RON"

bank_id

string<uuid>[]

Doar rândurile de pe conturile alimentate de aceste conexiuni bancare. Separate prin virgulă pentru mai multe.

account_id

string<uuid>[]

Doar rândurile de pe aceste conturi. Separate prin virgulă pentru mai multe.

category_id

string<uuid>[]

Doar rândurile din aceste categorii. Separate prin virgulă pentru mai multe. Pe /transactions se potrivește și cu o tranzacție împărțită ale cărei bucăți sunt în una dintre ele. Subcategoriile sunt incluse doar pe sinteze.

label_id

string<uuid>[]

Doar rândurile care poartă cel puțin una dintre aceste etichete. Separate prin virgulă pentru mai multe.

counterparty_id

string<uuid>[]

Doar rândurile atribuite acestor parteneri. Separate prin virgulă pentru mai multe.

direction

enum<string>

Dacă banii intră sau ies. Pe o tranzacție sau o previziune urmează semnul lui amount.

Opțiuni disponibile:

inflow,

outflow

activity

enum<string>[]

Doar rândurile a căror categorie se află în aceste secțiuni ale situației fluxurilor de numerar. Separate prin virgulă pentru mai multe.

Secțiunea din situația fluxurilor de numerar căreia îi aparține categoria.

Opțiuni disponibile:

operating,

investing,

financing

Răspuns

Sinteza.

object

string

obligatoriu

Allowed value: "summary"

period

object

obligatoriu

Fereastra efectiv calculată.

Show child attributes

conversion

object

obligatoriu

Ce s-a făcut pentru ca sumele să fie comparabile.

Show child attributes

group_by

enum<string> | null

obligatoriu

O dimensiune după care se grupează rândurile raportului, pe lângă intervalul de timp.

Opțiuni disponibile:

category,

counterparty,

label,

account,

activity,

direction

has_data

boolean

obligatoriu

false când nicio tranzacție nu s-a potrivit, spre deosebire de totalurile care au ieșit zero.

totals

object

obligatoriu

Întreaga fereastră însumată, după aceleași excluderi ca rândurile.

Show child attributes

data

object[]

obligatoriu

Show child attributes

Sintetizează tranzacțiile

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"
    }
  ]
}

Primii pași

MCP

API REST

Referință API

Sintetizează tranzacțiile

Autorizări

Parametri interogare

Răspuns