Listează tranzacțiile

Întoarce tranzacțiile ordonate după date descrescător, apoi după id.

Aceasta este un extras de cont: câte un rând pentru fiecare mișcare, așa cum a consemnat-o contul. Sunt întoarse toate mișcările, inclusiv cele două părți ale unui transfer între conturile proprii ale spațiului de lucru și tranzacțiile excluse de utilizator din cash flow. Niciuna nu este marcată, pentru că niciuna nu schimbă ce s-a întâmplat pe cont.

Tranzacțiile bancare în așteptare sunt întoarse cu status: pending. Duplicatele detectate de ThinkOut nu sunt întoarse niciodată și nu pot fi cerute.

Când o tranzacție a fost împărțită în ThinkOut, este întoarsă mișcarea originală, nu și bucățile ei. Rapoartele numără altfel; vezi /transactions/summary.

GET

transactions

Listează tranzacțiile

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

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

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

{
  "object": "list",
  "data": [
    {
      "object": "transaction",
      "id": "8f1c0a4e-2b1d-4c8e-9f3a-7d6e5c4b3a21",
      "date": "2026-09-03",
      "amount": "-1250.00",
      "currency": "RON",
      "direction": "outflow",
      "status": "booked",
      "source": "bank",
      "description": "ORANGE ROMANIA SA",
      "comment": null,
      "account": "c2d7e8f9-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
      "category": "3b4c5d6e-7f80-4a1b-9c2d-3e4f5a6b7c8d",
      "counterparty": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
      "labels": [
        "1f2e3d4c-5b6a-4978-8877-665544332211"
      ],
      "bank_details": {
        "payer": "THINKOUT SRL",
        "payer_details": "RO49INGB0000999900000001",
        "payee": "ORANGE ROMANIA SA",
        "payee_details": "RO12BTRL0000000000000002",
        "reference": "Factura 2026-08 nr 1234567",
        "additional": null
      },
      "created_at": "2026-09-03T08:12:44Z",
      "updated_at": "2026-09-03T08:12:44Z"
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

{
  "error": {
    "type": "invalid_request",
    "code": "invalid_parameter",
    "message": "Parameter 'from' must be a date in YYYY-MM-DD format.",
    "param": "from",
    "request_id": "req_01J8ZT4Q7Y6M3K"
  }
}

{
  "error": {
    "type": "authentication",
    "code": "unauthorized",
    "message": "Invalid API key.",
    "param": null,
    "request_id": "req_01J8ZT4Q7Y6M3K"
  }
}

{
  "error": {
    "type": "rate_limit",
    "code": "rate_limited",
    "message": "Rate limit exceeded. Retry after 12 seconds.",
    "param": null,
    "request_id": "req_01J8ZT4Q7Y6M3K"
  }
}

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>

Cea mai veche date inclusă, inclusiv. Ignorat când este trimis period.

string<date>

Cea mai recentă date inclusă, inclusiv. Ignorat când este trimis period.

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. La tranzacții, se potrivește și cu o tranzacție împărțită ale cărei bucăți se află în una dintre ele, chiar dacă rândul în sine nu are categorie.

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 pe o previziune urmează semnul lui amount și nu îl poate contrazice niciodată. Există ca răspunsurile să poată fi grupate și citite fără să inspectezi semnele.

Opțiuni disponibile:

inflow,

outflow

status

enum<string>

Tranzacțiile pending vin de la bancă și nu sunt încă înregistrate. Suma unei tranzacții în așteptare se poate schimba când se înregistrează, iar updated_at se modifică atunci, deci actualizează după id în loc să tratezi un rând în așteptare ca final.

Opțiuni disponibile:

booked,

pending

expand

enum<string>[]

Relații de întors ca obiecte complete în loc de identificatori. Separate prin virgulă.

Fără el, fiecare relație este un identificator. Numind una aici, identificatorul este înlocuit cu obiectul către care arată. Extinderea merge un singur nivel; un nume nesuportat este respins.

Aici se acceptă: account, category, counterparty, labels.

Opțiuni disponibile:

account,

category,

counterparty,

labels

limit

integer

implicit:100

Dimensiunea paginii.

Interval necesar: 1 <= x <= 500

cursor

string

Token opac din next_cursor al paginii anterioare.

Răspuns

O pagină de tranzacții.

object

string

obligatoriu

Allowed value: "list"

data

object[]

obligatoriu

Show child attributes

has_more

boolean

obligatoriu

Dacă mai există o pagină.

next_cursor

string | null

obligatoriu

Trimite-l ca cursor pentru pagina următoare. null pe ultima pagină.

⌘I

Listează tranzacțiile

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

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

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

{
  "object": "list",
  "data": [
    {
      "object": "transaction",
      "id": "8f1c0a4e-2b1d-4c8e-9f3a-7d6e5c4b3a21",
      "date": "2026-09-03",
      "amount": "-1250.00",
      "currency": "RON",
      "direction": "outflow",
      "status": "booked",
      "source": "bank",
      "description": "ORANGE ROMANIA SA",
      "comment": null,
      "account": "c2d7e8f9-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
      "category": "3b4c5d6e-7f80-4a1b-9c2d-3e4f5a6b7c8d",
      "counterparty": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
      "labels": [
        "1f2e3d4c-5b6a-4978-8877-665544332211"
      ],
      "bank_details": {
        "payer": "THINKOUT SRL",
        "payer_details": "RO49INGB0000999900000001",
        "payee": "ORANGE ROMANIA SA",
        "payee_details": "RO12BTRL0000000000000002",
        "reference": "Factura 2026-08 nr 1234567",
        "additional": null
      },
      "created_at": "2026-09-03T08:12:44Z",
      "updated_at": "2026-09-03T08:12:44Z"
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

{
  "error": {
    "type": "invalid_request",
    "code": "invalid_parameter",
    "message": "Parameter 'from' must be a date in YYYY-MM-DD format.",
    "param": "from",
    "request_id": "req_01J8ZT4Q7Y6M3K"
  }
}

{
  "error": {
    "type": "authentication",
    "code": "unauthorized",
    "message": "Invalid API key.",
    "param": null,
    "request_id": "req_01J8ZT4Q7Y6M3K"
  }
}

{
  "error": {
    "type": "rate_limit",
    "code": "rate_limited",
    "message": "Rate limit exceeded. Retry after 12 seconds.",
    "param": null,
    "request_id": "req_01J8ZT4Q7Y6M3K"
  }
}

Primii pași

Lucrul cu datele

MCP

Referință API

Listează tranzacțiile

Autorizări

Parametri interogare

Răspuns