> ## Documentation Index > Fetch the complete documentation index at: https://developers.thinkout.io/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## OpenAPI ````yaml /openapi/v1.ro.yaml get /balances openapi: 3.1.0 info: title: ThinkOut API version: '1.0' description: >- Acces programatic la datele unui spațiu de lucru ThinkOut. În versiunea 1 fiecare endpoint este un `GET`. Listele folosesc același înveliș de răspuns și se paginează cu un cursor oriunde lista poate crește. Versiunea 1 se schimbă doar prin adăugare. Pot apărea oricând endpointuri noi, parametri opționali noi, câmpuri noi în răspuns și valori noi de enumerare, așa că tolerați câmpurile necunoscute și nu tratați niciodată o enumerare ca pe o mulțime închisă. contact: name: Suport ThinkOut url: https://developers.thinkout.io/guides/support servers: - url: https://api.thinkout.io/v1 security: - apiKey: [] tags: - name: Bănci description: Conexiunile bancare ale spațiului de lucru și starea fiecăreia. - name: Conturi description: Conturi manuale, sincronizate cu banca și delegate, cu solduri calculate. - name: Tranzacții description: Mișcări înregistrate și în așteptare pe conturile spațiului de lucru. - name: Categorii description: Arborele de categorii al spațiului de lucru, pe direcție și activitate. - name: Parteneri description: >- Clienții și furnizorii cărora le sunt atribuite tranzacțiile și previziunile. - name: Etichete description: Etichete libere, grupate pe tipuri. - name: Previziuni description: Încasări și plăți planificate și tranzacțiile care le-au realizat. - name: Rapoarte description: >- Totaluri, nu rânduri. Sinteze peste tranzacții și previziuni, plus rapoartele de cash flow salvate în spațiul de lucru. paths: /balances: get: tags: - Rapoarte summary: Citește soldurile description: >- 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. operationId: getBalances parameters: - $ref: '#/components/parameters/as_of' - $ref: '#/components/parameters/currency' responses: '200': description: Soldurile pe fiecare cont și totalul. content: application/json: schema: $ref: '#/components/schemas/Balances' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/RateLimited' components: parameters: as_of: name: as_of in: query description: >- 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. schema: type: string format: date currency: name: currency in: query description: >- 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ă. schema: $ref: '#/components/schemas/Currency' schemas: Balances: type: object required: - object - as_of - conversion - total - accounts properties: object: type: string const: balances as_of: type: string format: date description: Ziua a cărei poziție la sfârșit de zi este raportată. conversion: $ref: '#/components/schemas/Conversion' total: $ref: '#/components/schemas/Money' description: Toate conturile adunate, în moneda cerută. accounts: type: array items: $ref: '#/components/schemas/AccountBalance' Currency: type: string description: Cod de monedă alfabetic ISO 4217. pattern: ^[A-Z]{3}$ example: RON Conversion: type: object description: Ce s-a făcut pentru ca sumele să fie comparabile. required: - applied - currency - basis properties: applied: type: boolean description: '`false` când toate sumele erau deja în `currency`.' currency: $ref: '#/components/schemas/Currency' basis: type: string description: >- `transaction_date` convertește fiecare mișcare la cursul din propria ei dată, ceea ce folosesc totalurile peste mișcări. `balance_date` convertește un sold întreg la un singur curs, ceea ce folosesc soldurile, pentru că un cont ține o singură monedă. enum: - transaction_date - balance_date - none Money: type: string description: >- 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]+)?$ example: '-1250.00' AccountBalance: type: object required: - account_id - name - native_currency - native_balance - balance properties: account_id: type: string format: uuid name: type: string example: ING Curent native_currency: $ref: '#/components/schemas/Currency' native_balance: $ref: '#/components/schemas/Money' description: Soldul în moneda proprie a contului, neconvertit. balance: $ref: '#/components/schemas/Money' description: Același sold în moneda cerută. Error: type: object required: - error properties: error: type: object required: - type - code - message - param - request_id properties: type: type: string enum: - invalid_request - authentication - not_found - rate_limit - server code: type: string description: >- Motiv stabil, citibil de o mașină. Ramifică pe acesta, nu pe `message`. Codurile specifice rapoartelor sunt `too_many_groups`, `period_too_long`, `as_of_in_future` și `invalid_expand`. message: type: string description: >- Explicație pentru oameni, în engleză. Formularea se poate schimba. param: type: - string - 'null' description: Parametrul de query sau de cale vinovat, când există unul. request_id: type: string description: Menționează-l când contactezi suportul. responses: BadRequest: description: Un parametru este invalid. content: application/json: schema: $ref: '#/components/schemas/Error' example: 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 Unauthorized: description: Cheia API lipsește, este necunoscută sau revocată. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: authentication code: unauthorized message: Invalid API key. param: null request_id: req_01J8ZT4Q7Y6M3K RateLimited: description: Prea multe cereri. Așteaptă numărul de secunde din `Retry-After`. headers: Retry-After: schema: type: integer description: Secunde de așteptat înainte de a reîncerca. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: rate_limit code: rate_limited message: Rate limit exceeded. Retry after 12 seconds. param: null request_id: req_01J8ZT4Q7Y6M3K securitySchemes: apiKey: type: http scheme: bearer description: >- O cheie API creată în setările ThinkOut. O cheie citește un singur spațiu de lucru. ````