> ## 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 un cont ## OpenAPI ````yaml /openapi/v1.ro.yaml get /accounts/{id} 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: /accounts/{id}: get: tags: - Conturi summary: Citește un cont operationId: getAccount parameters: - $ref: '#/components/parameters/id' - $ref: '#/components/parameters/as_of' - $ref: '#/components/parameters/account_expand' responses: '200': description: Contul. content: application/json: schema: $ref: '#/components/schemas/Account' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' components: parameters: id: name: id in: path required: true schema: type: string format: uuid 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 account_expand: name: expand in: query description: >- 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ă: `bank`. style: form explode: false schema: type: array items: type: string enum: - bank example: bank schemas: Account: type: object required: - object - id - name - currency - group - source - balance - balance_as_of - opening_balance - opening_date - bank - external_account_id - original_name - created_at - updated_at properties: object: type: string const: account id: type: string format: uuid name: type: string example: ING Curent currency: $ref: '#/components/schemas/Currency' group: type: - string - 'null' description: Grupare cu text liber, atribuită în ThinkOut. example: Operational source: $ref: '#/components/schemas/AccountSource' balance: $ref: '#/components/schemas/Money' balance_as_of: type: string format: date description: >- Ziua al cărei sold de sfârșit de zi este raportat. Calculat la momentul cererii. opening_balance: $ref: '#/components/schemas/Money' opening_date: type: string format: date description: >- Data la care se aplică soldul inițial. Nu sunt așteptate tranzacții înainte de ea. bank: $ref: '#/components/schemas/ExpandableBank' external_account_id: type: - string - 'null' description: >- Identificatorul contului la furnizor, util pentru reconciliere. `null` pentru conturile manuale. original_name: type: - string - 'null' description: >- Numele contului așa cum îl raportează banca, înainte de orice redenumire în ThinkOut. `null` pentru conturile manuale. created_at: type: string format: date-time updated_at: type: string format: date-time example: object: account id: c2d7e8f9-1a2b-4c3d-8e9f-0a1b2c3d4e5f name: ING Curent currency: RON group: Operational source: bank balance: '15230.45' balance_as_of: '2026-09-03' opening_balance: '1000.00' opening_date: '2024-01-01' bank: 5d6e7f80-9a1b-4c2d-8e3f-4a5b6c7d8e9f external_account_id: ACC-00012345 original_name: Cont curent RON created_at: '2024-01-01T10:00:00Z' updated_at: '2026-08-30T06:00:00Z' Currency: type: string description: Cod de monedă alfabetic ISO 4217. pattern: ^[A-Z]{3}$ example: RON AccountSource: type: string description: >- Conturile `delegated` sunt conturi bancare pe care alt spațiu de lucru le-a delegat către acesta. enum: - manual - bank - delegated 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' ExpandableBank: description: >- Identificatorul unei conexiuni bancare, conexiunea completă când este numită în `expand`, sau `null` pentru un cont manual. oneOf: - type: string format: uuid - $ref: '#/components/schemas/Bank' - type: 'null' 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. Bank: type: object description: >- O autorizare cu o singură bancă. Mai multe conturi pot folosi aceeași conexiune, iar un spațiu de lucru poate avea mai multe conexiuni la aceeași bancă. required: - object - id - name - country_code - status - last_sync_at - consent_expires_at - created_at - updated_at properties: object: type: string const: bank id: type: string format: uuid name: type: string description: Numele băncii, așa cum îl raportează furnizorul. example: ING Bank country_code: type: - string - 'null' description: Țara băncii, cod ISO 3166-1 alpha-2. pattern: ^[A-Z]{2}$ example: RO status: $ref: '#/components/schemas/BankStatus' last_sync_at: type: - string - 'null' format: date-time description: >- Când a întors furnizorul date cu succes ultima oară. `null` dacă nu a făcut-o niciodată. Aceasta este vechimea datelor, nu vechimea conexiunii. O conexiune poate sta pe `connected` cu un `last_sync_at` vechi de câteva zile, iar acesta este cazul care merită o alertă. consent_expires_at: type: - string - 'null' format: date-time description: >- Când trebuie reînnoit consimțământul bancar, dacă furnizorul îl raportează. După ce trece, conexiunea nu mai întoarce tranzacții noi până când cineva o reaprobă. created_at: type: string format: date-time description: Când a fost autorizată prima dată conexiunea. updated_at: type: string format: date-time example: object: bank id: 5d6e7f80-9a1b-4c2d-8e3f-4a5b6c7d8e9f name: ING Bank country_code: RO status: connected last_sync_at: '2026-09-03T06:00:00Z' consent_expires_at: '2026-11-30T00:00:00Z' created_at: '2024-01-01T10:00:00Z' updated_at: '2026-09-03T06:00:00Z' BankStatus: type: string description: >- Starea conexiunii la ultimul schimb de date dintre ThinkOut și furnizor. `connected` înseamnă că funcționează. `loading` este o sincronizare în curs. `requires_action` cere ca o persoană să se autentifice sau să reaprobe conexiunea în ThinkOut, iar până atunci nu mai vin tranzacții noi. `error` este o eroare pe care ThinkOut nu a putut să o rezolve singur și acoperă orice stare a furnizorului pe care ThinkOut nu o poate încadra. Doar `connected` înseamnă că datele din spate sunt la zi. enum: - connected - loading - requires_action - error 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 NotFound: description: Nu există niciun obiect cu acest id în spațiul de lucru al cheii. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: not_found code: resource_not_found message: No transaction with id 8f1c0a4e-2b1d-4c8e-9f3a-7d6e5c4b3a21. param: id 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. ````