---
title: "Get a specific bank connection"
method: GET
path: "/api/connections/{connection-id}"
tags: ["XS2A.api.connections"]
---

# Get a specific bank connection

`GET /api/connections/{connection-id}`

## Path parameters

- `connection-id` string, required

## Response `200`

Request successfully processed

- BankConnection
  - `id` string — Bank Connection ID
  - `transaction` string — Internally used XS2A transaction id.
  - `bic` string — BIC of the bank of the bank connection
  - `bank_name` string — The name of the bank of the bank connection
  - `country_id` 'DE' | 'AT' | 'CH' — The 2-letter country code
  - `sync_mode` 'full' | 'shared' | 'none' — The mode how the bank connection is synced.
  - `sync_active` boolean — Indicates whether the sync is active
  - `sync_message` string — ???
  - `sync_fail_counter` integer — A counter of failed syncs for this connection
  - `last_synced` string — The date when the connection was last synced
  - `consent_valid_until` string — The consent is valid until the given date (Format: YYYY-MM-DD).
  - `testmode` boolean — Indicates whether this bank connection is in test mode
  - `created_at` string — Date of creation
  - `object` string — The value bank_connection

## Other responses

- `401` — Authentication failed API key missing or not valid
- `403` — Forbidden Access blocked
- `404` — Product not enabled or Not found The requested object does not exist on the server
- `422` — Validation failed Something is wrong with the user input
- `500` — An internal server problem occurred

---

[API](https://skmtc.dev/xs2a/apis/xs2a-api.md) · [All operations](https://skmtc.dev/xs2a/apis/xs2a-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/xs2a/xs2a-api/revisions/ae5fbc5feee3/schema)