---
title: "Get a list of all bank connections for a xs2a.api bank user"
method: GET
path: "/api/connections"
tags: ["XS2A.api.connections"]
---

# Get a list of all bank connections for a xs2a.api bank user

`GET /api/connections`

## Query parameters

- `per_page` integer
- `page` integer

## Response `200`

Request successfully processed

- BankConnectionList
  - `total` integer — Total number of results.
  - `per_page` integer — Number of objects per page
  - `current_page` integer — Current page.
  - `last_page` integer — Last page, usually the total of available pages.
  - `next_page_url` string, nullable — URI to next page.
  - `prev_page_url` string, nullable — URI to previous page.
  - `from` integer — Showing results from index element.
  - `to` integer — Showing results to index element.
  - `data` 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)