> ## 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. # Get a bank connection > Returns one bank connection. ## OpenAPI ````yaml /openapi/v1.yaml get /banks/{id} openapi: 3.1.0 info: title: ThinkOut API version: '1.0' description: > Programmatic access to the data of a ThinkOut workspace. Every endpoint in version 1 is a `GET`. Lists share one response envelope, and page with a cursor wherever the list can grow. Version 1 changes additively. New endpoints, new optional parameters, new response fields and new enum values can appear at any time, so tolerate unknown fields and never treat an enum as a closed set. contact: name: ThinkOut developer support url: https://developers.thinkout.io/guides/support servers: - url: https://api.thinkout.io/v1 security: - apiKey: [] tags: - name: Banks description: The workspace's bank connections and the state of each one. - name: Accounts description: Manual, bank-synced and delegated accounts with computed balances. - name: Transactions description: Booked and pending movements on the workspace's accounts. - name: Categories description: The workspace category tree, split by direction and business activity. - name: Counterparties description: Customers and suppliers that transactions and forecasts are attributed to. - name: Labels description: Free-form tags grouped by label type. - name: Forecasts description: Planned inflows and outflows and the transactions that realised them. - name: Reports description: >- Totals rather than rows. Summaries over transactions and forecasts, and the workspace's own saved cash flow views. paths: /banks/{id}: get: tags: - Banks summary: Get a bank connection description: Returns one bank connection. operationId: getBank parameters: - $ref: '#/components/parameters/id' responses: '200': description: The bank connection. 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: > One authorisation with one bank. Several accounts can share a connection, and a workspace can hold several connections to the same bank. 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: The bank's name as the provider reports it. example: ING Bank country_code: type: - string - 'null' description: ISO 3166-1 alpha-2 country of the bank. pattern: ^[A-Z]{2}$ example: RO status: $ref: '#/components/schemas/BankStatus' last_sync_at: type: - string - 'null' format: date-time description: > When the provider last returned data successfully. `null` when it never has. This is the age of the data, not the age of the connection. A connection can sit at `connected` with a `last_sync_at` days old, which is the case worth alerting on. consent_expires_at: type: - string - 'null' format: date-time description: > When the bank consent needs renewal, if the provider reports it. Once it passes, the connection stops returning new transactions until someone re-approves it. created_at: type: string format: date-time description: When the connection was first authorised. 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: > The state of the connection as of ThinkOut's last exchange with the provider. `connected` is working. `loading` is a sync in progress. `requires_action` needs a person to sign in or re-approve the connection in ThinkOut, and no new transactions arrive until they do. `error` is a failure ThinkOut could not resolve on its own, and covers any provider state ThinkOut cannot place. Only `connected` means the data behind it is current. 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: > Stable machine-readable reason. Branch on this, not on `message`. Report-specific codes are `too_many_groups`, `period_too_long`, `as_of_in_future` and `invalid_expand`. message: type: string description: Human-readable explanation. Wording may change. param: type: - string - 'null' description: The query or path parameter at fault, when there is one. request_id: type: string description: Quote this when contacting support. responses: BadRequest: description: A parameter is 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: The API key is missing, unknown or revoked. 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: No object with this id exists in the key's workspace. 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: >- A workspace API key created in ThinkOut settings. One key reads one workspace. ````