> ## 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 o conexiune bancară > Întoarce o conexiune bancară. ## OpenAPI ````yaml /openapi/v1.ro.yaml get /banks/{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: /banks/{id}: get: tags: - Bănci summary: Citește o conexiune bancară description: Întoarce o conexiune bancară. operationId: getBank parameters: - $ref: '#/components/parameters/id' responses: '200': description: Conexiunea bancară. content: application/json: schema: $ref: '#/components/schemas/Bank' '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 schemas: 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 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 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. ````