Bankzugänge lesen
Benötigte Berechtigung:read(Daten lesen)
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.
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
Die Bankzugänge der Bankkonten der Firma.
items?array<>|Ein Eintrag je Bankkonto mit Bankzugang.
truncated?booleanTrue, wenn die Firma mehr als 100 Bankkonten hat; die übrigen fehlen dann.
curl --fail-with-body "https://app.bimetrics.de/api/bankaccount/connections" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "items": [ { "bankAccountId": "8faaa132-ef45-4af2-8dbb-a139b051f10f", "lastSync": "2026-10-31T06:00:00Z", "status": "active", "validUntil": { "day": 15, "month": 1, "year": 2027 } } ], "truncated": false}Ähnlichen Kontakt als andere Firma markieren POST
Sagt, dass die Kontakte `contactId` und `{id}` verschiedene Firmen oder Personen sind, etwa zwei Privatkunden mit gleichem Namen. Das entspricht dem Link „Nicht dieselbe“ im Hinweis der App. Lassen sich keine Belege mehr verschieben, heißt derselbe Link dort „Hinweis ausblenden“. Der Aufruf blendet nur den Hinweis an beiden Kontakten aus. Er lässt sich deshalb auch nutzen, wenn es dieselbe Firma ist und sich nichts mehr zusammenführen lässt. Danach steht keiner der beiden mehr in der Liste des anderen (`GET /api/contact/{id}/similar`). Die Antwort ist die Liste, die für `{id}` übrig bleibt. Kontakte und Belege ändern sich nicht, auch nicht das `updatedAt` der Kontakte. Ein zweiter Aufruf mit demselben Paar ändert nichts. Zurücknehmen lässt sich die Markierung nicht, auch nicht in der App; zusammenführen lassen sich die beiden weiter mit `POST /api/contact/{id}/merge`. Fehlt `contactId` oder ist es die ID von `{id}` selbst, antwortet die API mit `400 InvalidContactWrite`. Gibt es in der eigenen Firma keinen Kontakt mit einer der beiden IDs, antwortet sie mit `404`. Benötigt einen Schlüssel mit der Berechtigung `contacts:write`.
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`.