> ## Documentation Index
> Fetch the complete documentation index at: https://docs.business-os.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Connections

> Bankverbindungen einer Organisation abrufen und verwalten.

## Definition

Eine Connection ist die Kopplung deines Online Banking Zugangs in unserem Backend. Eine Connection kann mehrere Accounts enthalten, wenn du mit deinem Online Banking Zugang Zugriff zu mehreren Bankkonten hast.

## List Connections (READ)

Dieses Modul zeigt alle Connections an, also alle Online Banking Zugänge, die du im Business OS Back-End gekoppelt hast.

<ResponseExample>
  ```200 - Erfolg theme={null}
  {
    "data": [
      {
        "id": "9182736450918273645",
        "provider_name": "Musterbank",
        "provider_code": "musterbank_de",
        "country_code": "DE",
        "status": "active",
        "automatic_refresh": true,
        "next_refresh_possible_at": "2026-02-19T06:26:03Z",
        "created_at": "2026-01-03T14:39:58Z",
        "updated_at": "2026-02-19T06:11:03Z",
        "display_name": "Mustermann GmbH – Geschäftskonto",
        "logo_url": "https://cdn.business-os.de/logos/providers/musterbank_de.svg",
        "consent_expires_at": "2026-07-19T06:11:03Z",
        "error_class": null,
        "error_message": null
      },
      {
        "id": "8273645091827364509",
        "provider_name": "Sparmuster eG",
        "provider_code": "sparmuster_de",
        "country_code": "DE",
        "status": "inactive",
        "automatic_refresh": false,
        "next_refresh_possible_at": null,
        "created_at": "2026-01-15T13:55:11Z",
        "updated_at": "2026-03-20T09:12:44Z",
        "display_name": "Mustermann GmbH – Tagesgeld",
        "logo_url": "https://cdn.business-os.de/logos/providers/sparmuster_de.svg",
        "consent_expires_at": "2026-04-15T13:55:28Z",
        "error_class": "ConnectionExpired",
        "error_message": "Die Bank-Einwilligung ist abgelaufen. Bitte neu verbinden."
      }
    ]
  }
  ```
</ResponseExample>

## Verbrauch

<Check>
  Für das Verwalten und Abrufen von Verbindungen werden **keine Credits** berechnet. Credits fallen erst bei Datenabrufen (Transaktionen) und Zahlungen an.
</Check>