Skip to main content
GET
Citește o tranzacție

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 cale

id
string<uuid>
obligatoriu

Parametri interogare

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

Răspuns

Tranzacția.

object
string
obligatoriu
Allowed value: "transaction"
id
string<uuid>
obligatoriu
date
string<date>
obligatoriu

Data înregistrării. Nu există componentă de timp.

Exemplu:

"2026-09-03"

amount
string
obligatoriu

Sumă zecimală ca șir de caractere. Cu semn la tranzacții, previziuni și cifre din rapoarte, unde negativ înseamnă ieșire. Semnul este cel care contează: direction este derivat din el, iar cele două nu pot fi niciodată în contradicție.

Pattern: ^-?[0-9]+(\.[0-9]+)?$
Exemplu:

"-1250.00"

currency
string
obligatoriu

Cod de monedă alfabetic ISO 4217.

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

"RON"

direction
enum<string>
obligatoriu

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>
obligatoriu

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
source
enum<string>
obligatoriu

Cum a intrat tranzacția în ThinkOut.

Opțiuni disponibile:
manual,
import,
bank
description
string | null
obligatoriu
Exemplu:

"ORANGE ROMANIA SA"

comment
string | null
obligatoriu

Text liber adăugat de utilizatori în ThinkOut.

account
obligatoriu

Identificatorul unui cont, sau contul complet când este numit în expand.

category
obligatoriu

null când tranzacția nu are categorie. Aici intră și orice tranzacție împărțită în ThinkOut, unde categorisirea a trecut pe bucăți, iar bucățile nu sunt expuse de acest API.

counterparty
obligatoriu

Identificatorul unui partener, partenerul complet când este numit în expand, sau null când tranzacția nu este atribuită.

labels
(string<uuid> | object)[]
obligatoriu

Identificatori de etichete, sau etichetele complete când labels este numit în expand.

bank_details
object | null
obligatoriu

Câmpuri brute primite de la bancă. Prezente doar pe tranzacțiile cu source: bank.

created_at
string<date-time>
obligatoriu
updated_at
string<date-time>
obligatoriu