Konten ohne Bankverbindung lesen
Benötigte Berechtigung:read(Daten lesen)
Listet die aktiven Bankkonten ohne Bankverbindung mit dem Zeitraum ihrer Umsätze und dem letzten Import.
Benötigt einen Schlüssel mit der Berechtigung read.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
Erfolg.
application/json- response
Aktive Bankkonten ohne Bankverbindung.
items?array<>|Die Konten.
curl --fail-with-body "https://app.bimetrics.de/api/bankstatement/accounts" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "items": [ { "bankAccountId": "6d3a90f2-1e74-4b8c-a5d0-93c7f2e41b68", "currency": "EUR", "disabled": false, "formerlyConnected": false, "from": "2026-01-02", "iban": "DE02120300000000202051", "institutionId": null, "institutionName": "", "lastImportAt": "2026-10-01T08:00:00Z", "name": "Girokonto", "to": "2026-09-30" } ]}Mail zurückholen POST
Holt eine Mail von „Erledigt“ nach „Offen“, wie „Zurückholen“ in der App. Erst dann lassen sich weitere Anhänge übernehmen. Benötigt einen Schlüssel mit der Berechtigung `inbox:write`.
Kontoauszug übernehmen POST
Übernimmt, was die Vorschau gezeigt hat: Jede neue Zeile wird zum Umsatz mit Buchung und automatischer Zuordnung, im Hintergrund. Das lässt sich nicht rückgängig machen. Ohne Vorschau mit genau diesem Konto und dieser Zuordnung aus den letzten 60 Minuten: `409 BankStatementPreviewRequired`. Prüf-Fälle werden nur geschrieben, wenn `includeReviewPositions` sie nennt, und nur solche, die die Vorschau gezeigt hat. Unter 50 % lesbaren Zeilen oder ohne etwas zu übernehmen: `409 BankStatementNothingToApply`. Beim Einlesen vergleicht bimetrics noch einmal, die Zahlen können also abweichen; `getStatementImport` nennt das Ergebnis. Dieselbe Datei wird nur einmal übernommen (`409 BankStatementAlreadyImported`). Benötigt einen Schlüssel mit der Berechtigung `statements:import`.