bimetricsEntwickler
Bankkonten

Bankkonto lesen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

GET
/api/bankaccount/{id}

Liefert ein verbundenes Bankkonto mit Saldo.

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.

Pfadparameter

id*string

ID des Bankkontos (UUID).

Formatuuid

Antworten

Erfolg.

application/json
  1. response

Ein mit bimetrics verbundenes Bankkonto.

IBAN?string

IBAN.

accountOwner?|

Diese Mitgliedschaft, ohne Personendaten.

accountOwnerId?string

ID der Mitgliedschaft, die das Konto verbunden hat.

Formatuuid
balance?integer

Saldo in Cent zum Zeitpunkt balanceDate.

balanceAvailable?boolean

Die Bank hat einen Saldo geliefert. Fehlt bei älteren Konten.

balanceCurrency?string

Währung des Saldos. Fehlt bei älteren Konten.

balanceDate?string

Zeitpunkt des Saldos.

Formatdate-time
bankName?string

Name der Bank.

companyId?string

ID der Firma.

Formatuuid
connected?boolean

Das Konto hat gerade eine Bankverbindung; ohne sie kommen Umsätze nur aus eingelesenen Kontoauszügen.

createdAt?string

Anlage in bimetrics.

Formatdate-time
currency?string

Kontowährung (ISO 4217).

deletedAt?|

Gilt als gelöscht seit diesem Zeitpunkt; null, solange nicht gelöscht. Gelöschte Einträge liefern nur die Suchrouten mit includeDeleted.

Formatdate-time
disabled?boolean

Das Konto ist deaktiviert; seine Umsätze erscheinen nicht in filterBankTransactions.

displayName?string

Name des Kontos in bimetrics: der eigene Name, sonst aus den Angaben der Bank abgeleitet.

id?string

ID des Bankkontos.

Formatuuid
ownerName?string

Kontoinhaber laut Bank.

productName?string

Kontobezeichnung der Bank.

updatedAt?string

Letzte Änderung.

Formatdate-time
Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/bankaccount/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
{  "IBAN": "DE89370400440532013000",  "accountOwner": {    "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5",    "createdAt": "2026-03-02T11:20:05Z",    "id": "53cd10a9-c864-4dc3-a777-9860d59efe6c",    "mcpAccess": "",    "role": "owner",    "status": "active",    "updatedAt": "2026-03-02T11:20:05Z",    "userId": "3ea56d84-7ca1-4a4f-88d4-428c62c8aee5"  },  "accountOwnerId": "53cd10a9-c864-4dc3-a777-9860d59efe6c",  "balance": 2465032,  "balanceAvailable": true,  "balanceCurrency": "EUR",  "balanceDate": "2026-09-27T05:00:12Z",  "bankName": "Commerzbank",  "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5",  "connected": true,  "createdAt": "2026-03-02T11:48:30Z",  "currency": "EUR",  "deletedAt": null,  "disabled": false,  "displayName": "Geschäftskonto",  "id": "8faaa132-ef45-4af2-8dbb-a139b051f10f",  "ownerName": "Hansen & Kowalski Werbetechnik GmbH",  "productName": "Geschäftskonto",  "updatedAt": "2026-09-27T05:00:12Z"}

Bankkonten suchen POST

Sucht die verbundenen Bankkonten der Firma mit einem Filter und liefert eine Seite der Treffer. `accountOwner` nennt nur die Mitgliedschaft des Kontoinhabers, keine Personendaten. Benötigt einen Schlüssel mit der Berechtigung `read`.

Umsätze suchen POST

Sucht Bankumsätze der Firma mit einem Filter und liefert eine Seite der Treffer. Umsätze deaktivierter Konten sind nicht enthalten. Benötigt einen Schlüssel mit der Berechtigung `read`.