> ## 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. # Listează conexiunile bancare > Întoarce conexiunile bancare ale spațiului de lucru, ordonate după `name`, apoi după `id`. O conexiune este o autorizare cu o singură bancă și poate alimenta mai multe conturi. Conexiunile delegate din alt spațiu de lucru sunt incluse atunci când alimentează un cont vizibil aici, așa că orice `bank` de pe un cont poate fi citit prin acest endpoint. Conturile manuale nu au conexiune și nu apar aici. ## OpenAPI ````yaml /openapi/v1.ro.yaml get /banks 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: get: tags: - Bănci summary: Listează conexiunile bancare description: >- Întoarce conexiunile bancare ale spațiului de lucru, ordonate după `name`, apoi după `id`. O conexiune este o autorizare cu o singură bancă și poate alimenta mai multe conturi. Conexiunile delegate din alt spațiu de lucru sunt incluse atunci când alimentează un cont vizibil aici, așa că orice `bank` de pe un cont poate fi citit prin acest endpoint. Conturile manuale nu au conexiune și nu apar aici. operationId: listBanks parameters: - name: status in: query schema: $ref: '#/components/schemas/BankStatus' - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/cursor' responses: '200': description: O pagină de conexiuni bancare. content: application/json: schema: allOf: - $ref: '#/components/schemas/List' - type: object properties: data: type: array items: $ref: '#/components/schemas/Bank' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/RateLimited' components: schemas: 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 List: type: object required: - object - data - has_more - next_cursor properties: object: type: string const: list data: type: array items: {} has_more: type: boolean description: Dacă mai există o pagină. next_cursor: type: - string - 'null' description: >- Trimite-l ca `cursor` pentru pagina următoare. `null` pe ultima pagină. 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' 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. parameters: limit: name: limit in: query description: Dimensiunea paginii. schema: type: integer minimum: 1 maximum: 500 default: 100 cursor: name: cursor in: query description: Token opac din `next_cursor` al paginii anterioare. schema: type: string 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. ````