Citește soldurile

Soldul fiecărui cont și totalul spațiului de lucru, într-un singur apel.

Soldurile sunt doar istorice. Un sold este soldul inițial al contului plus sumele cu semn ale tranzacțiilor sale până la sfârșitul zilei as_of, așa că o dată as_of din viitor este respinsă, în loc să primești cifra de azi purtând o dată viitoare. Pentru o poziție în viitor, calculează un raport de cash flow de tip balances, care proiectează mișcările planificate și le raportează separat de cele reale.

Conversia diferă aici față de sinteze, în mod deliberat. Un cont ține o singură monedă, deci soldul lui se convertește integral la un singur curs pentru as_of, răspunzând la întrebarea cât valorează poziția atunci. O sinteză de tranzacții convertește fiecare mișcare la data ei, răspunzând la întrebarea cât a costat fiecare la momentul respectiv.

GET

balances

Citește soldurile

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

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

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

{
  "object": "balances",
  "as_of": "2023-12-25",
  "conversion": {
    "applied": true,
    "currency": "RON",
    "basis": "transaction_date"
  },
  "total": "-1250.00",
  "accounts": [
    {
      "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "ING Curent",
      "native_currency": "RON",
      "native_balance": "-1250.00",
      "balance": "-1250.00"
    }
  ]
}

{
  "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

as_of

string<date>

Calculează soldurile la sfârșitul acestei zile. Implicit ziua curentă în UTC. O dată din viitor este respinsă, pentru că un sold este întotdeauna istoric.

currency

string

Moneda în care sunt raportate totalurile. Implicit moneda spațiului de lucru. Obiectul conversion din răspuns spune dacă s-a făcut conversie și pe ce bază. Cod de monedă alfabetic ISO 4217.

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

Exemplu:

"RON"

Răspuns

Soldurile pe fiecare cont și totalul.

object

string

obligatoriu

Allowed value: "balances"

as_of

string<date>

obligatoriu

Ziua a cărei poziție la sfârșit de zi este raportată.

conversion

object

obligatoriu

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

Show child attributes

total

string

obligatoriu

Toate conturile adunate, în moneda cerută.

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

Exemplu:

"-1250.00"

accounts

object[]

obligatoriu

Show child attributes

⌘I

Citește soldurile

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

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

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

{
  "object": "balances",
  "as_of": "2023-12-25",
  "conversion": {
    "applied": true,
    "currency": "RON",
    "basis": "transaction_date"
  },
  "total": "-1250.00",
  "accounts": [
    {
      "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "ING Curent",
      "native_currency": "RON",
      "native_balance": "-1250.00",
      "balance": "-1250.00"
    }
  ]
}

{
  "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

Citește soldurile

Autorizări

Parametri interogare

Răspuns