bimetricsEntwickler
Bankkonten

Bankzugänge lesen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

GET
/api/bankaccount/connections

Liefert je Bankkonto den Stand des Bankzugangs, über den seine Umsätze kommen, wie die App unter Einstellungen › Bank. Läuft er ab (validUntil) oder steht er auf reconnect_required oder expired, kommen keine neuen Umsätze, bis jemand ihn in der App erneuert. Bankkonten ohne Bankzugang fehlen.

Benötigt einen Schlüssel mit der Berechtigung read.

Authentifizierung

headerAuthentifizierungBearer <bm_…>

Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.

Antworten

Erfolg.

application/json
  1. response

Die Bankzugänge der Bankkonten der Firma.

items?array<>|

Ein Eintrag je Bankkonto mit Bankzugang.

truncated?boolean

True, wenn die Firma mehr als 100 Bankkonten hat; die übrigen fehlen dann.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/bankaccount/connections" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
{  "items": [    {      "bankAccountId": "8faaa132-ef45-4af2-8dbb-a139b051f10f",      "lastSync": "2026-10-31T06:00:00Z",      "status": "active",      "validUntil": {        "day": 15,        "month": 1,        "year": 2027      }    }  ],  "truncated": false}