# Kontoauszug ansehen (https://developer.bimetrics.de/reference/bank-statements/inspect-statement)

`POST https://app.bimetrics.de/api/bankstatement/inspect`

operationId: `inspectStatement` · Berechtigung (Scope): `statements:import` · Bereich: Kontoauszüge

Liest den Anfang der Datei und schlägt Spalten (`mapping`), Format und Zielkonto vor, mit bis zu 20 Zeilen, wie bimetrics sie liest. Es wird nichts gespeichert. Mit `mapping` im Anfrageinhalt liest die Route die Zeilen mit dieser Zuordnung.

Benötigt einen Schlüssel mit der Berechtigung `statements:import`.

> **Achtung:** Dieser Aufruf ist nicht als rein lesend gekennzeichnet und kann echte Daten in der Firma anlegen oder ändern. Es gibt keine Testumgebung.
>
> KI-Agenten fragen vor diesem Aufruf beim Nutzer nach.

### Authentifizierung

`Authorization: Bearer bm_…` (alternativ `X-API-KEY: bm_…`, nie beide zugleich).

### Request-Body (`application/json`)

Upload und optional die Zuordnung der Spalten

Schema `StatementInspectRequest`.

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `bankAccountId` | string (uuid), kann null sein | Das Konto, falls schon festgelegt. |
| `mapping` | StatementMapping | Eine Zuordnung, mit der die Zeilen gelesen werden sollen. |
| `uploadId` | string (uuid) | ID des Uploads. |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/bankstatement/inspect" \
  -H "Authorization: Bearer $BIMETRICS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"and","children":[],"limit":50,"offset":0}'
```

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Erfolg. | `application/json`: StatementInspection |
| 400 | Ungültige Anfrage, z. B. ein Parameter mit ungültigem Wert wie eine ID, die keine UUID ist; korrigieren statt wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |
| 401 | Kein gültiger Schlüssel: fehlt (`Unauthorized`), ist unbekannt, abgelaufen oder widerrufen oder wurde nicht in genau einem Header gesendet (`InvalidAPIKey`). Schlüssel prüfen, nicht wiederholen. Auch eine ID, die zu einer anderen Firma gehört, ergibt `401 Unauthorized`. | `application/json`: Error |
| 403 | Dem Schlüssel fehlt die Berechtigung für diese Route (`APIKeyPermissionDenied`), oder die Firma hat keinen API-Zugang (mehr), etwa nach Ende der Testphase oder des Abos (`APIUnavailable`). | `application/json`: Error |
| 404 | Nicht gefunden (`NotFound`). | `application/json`: Error |
| 413 | Die Anfrage ist zu groß (`APIRequestTooLarge`), siehe `x-bimetrics-limits`. | `application/json`: Error |
| 429 | Zu viele Anfragen; nach `Retry-After` Sekunden erneut senden. Mehr unter [Fehler](https://developer.bimetrics.de/errors). (Header: Retry-After) | `application/json`: Error |
| 500 | Serverfehler; die Anfrage später wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |

#### Felder der Antwort 200 (`StatementInspection`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `account` | StatementInspectAccount | Zielkonto. |
| `columns` | Array<StatementColumn>, kann null sein | Spalten der Datei mit einem Beispielwert. |
| `dateCandidates` | Array<string>, kann null sein | Passende Datumsformate. Mehr als eines: nachfragen. |
| `direct` | boolean | Das Konto passt und, bei einer Datei mit Spalten, die gespeicherte Zuordnung. Die Vorschau kann direkt folgen. |
| `fileName` | string | Name der Datei. |
| `format` | StatementFormat | Erkanntes Format. |
| `invertSuggested` | boolean | Die Salden passen nur mit umgekehrtem Vorzeichen. |
| `kind` | string | Art der Datei. |
| `mapping` | StatementMapping | Vorgeschlagene Zuordnung. |
| `mappingSource` | string | `saved` die zuletzt am Konto benutzte, `detected` erkannt, `request` aus der Anfrage. |
| `readableShare` | number | Anteil lesbarer Zeilen dieser Stichprobe, 0 bis 1. |
| `rows` | Array<StatementInspectRow>, kann null sein | Bis zu 20 Zeilen, wie bimetrics sie liest. |
| `saved` | StatementSavedMapping | Die gespeicherte Zuordnung des Kontos, falls vorhanden. |
| `uploadId` | string (uuid) | ID des Uploads. |

Verschachtelte Schemas stehen vollständig in der OpenAPI-Beschreibung: https://app.bimetrics.de/api/openapi.json