bimetricsEntwickler
Kontoauszüge

Import lesen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

GET
/api/bankstatement/imports/{id}

Liefert Stand, Fortschritt und Ergebnis eines übernommenen Imports. lateReview zählt Prüf-Fälle, die erst beim Einlesen auffielen: Sie sind geschrieben, die Vorschau zeigte sie nicht.

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 Imports (UUID).

Formatuuid

Antworten

Erfolg.

application/json
  1. response

Ein übernommener Import.

accountName?string

Name des Kontos.

bankAccountId?string

ID des Kontos.

Formatuuid
canRetry?boolean

Der Import lässt sich wiederholen.

createdAt?string

Zeitpunkt der Übernahme.

Formatdate-time
createdBy?string

Wer übernommen hat.

errorCode?|

Grund bei failed.

fileName?string

Name der Datei.

finishedAt?|

Ende des Imports.

Formatdate-time
from?string

Erster Buchungstag der Datei, leer vor dem Vergleich.

id?string

ID des Imports.

Formatuuid
jobId?string

ID des Hintergrundauftrags.

Formatuuid
progress?

Fortschritt.

result?|

Das Ergebnis, sobald der Import fertig ist.

state?string

queued, running, waiting, done oder failed.

to?string

Letzter Buchungstag der Datei.

waitReason?|

Worauf der Import wartet, etwa den Bankabruf.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/bankstatement/imports/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
{  "accountName": "Girokonto",  "bankAccountId": "6d3a90f2-1e74-4b8c-a5d0-93c7f2e41b68",  "canRetry": false,  "createdAt": "2026-11-05T09:15:00Z",  "createdBy": "Hans Beispiel",  "errorCode": null,  "fileName": "umsaetze.csv",  "finishedAt": null,  "from": "2026-09-01",  "id": "1b7e4f30-5c2a-4d18-9e63-7a0c2f815d44",  "jobId": "c92e1d07-48b6-4f1a-8d35-2b6a9e07f3c1",  "progress": {    "done": 0,    "total": 0  },  "result": null,  "state": "queued",  "to": "2026-09-30",  "waitReason": null}

Laufende Importe lesen GET

Listet die laufenden, wartenden und fehlgeschlagenen Importe der Firma, neueste zuerst. Einen abgeschlossenen liest `getStatementImport`. Benötigt einen Schlüssel mit der Berechtigung `read`.

Originaldatei eines Imports laden GET

Liefert die Datei eines übernommenen Imports Byte für Byte. Benötigt einen Schlüssel mit der Berechtigung `read`.