---
title: "Kontoauszug als JSON lesen (camt.052/053/054, camt.086)"
method: POST
path: "/statements/parse"
tags: ["Kontoauszüge"]
---

# Kontoauszug als JSON lesen (camt.052/053/054, camt.086)

`POST /statements/parse`

## Request

- Base URL: `https://finisma.de/api/v1`
- URL: `https://finisma.de/api/v1/statements/parse`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://finisma.de/api/oauth/authorize`, token URL `https://finisma.de/api/oauth/token`, scopes: `invoice:verify`, `invoice:create`)

Liest dieselben Formate in strukturiertes JSON: bei camt.052/053/054 Konten, Salden und Buchungen mit Transaktionen (Gegenpartei, IBAN, Verwendungszweck, End-to-End-Referenz, BkTxCd mit GVC), bei camt.086 Abrechnungen mit Services und Summen je Währung. Keine Schemaprüfung. Nichts wird gespeichert. Kostenlos bis 5 Aufrufe pro Monat und Konto. Mit dem Zahlungsverkehr-Abo (Feature payments) ohne Limit. Ohne Abo kostet jeder weitere Aufruf 1 Credit. Ein Konto (API-Key oder OAuth) ist immer nötig.

## Request body

- object
  - `xml` string: Die Datei als XML-Text (max. 10 MB). Alternativ 'file_base64'.
  - `file_base64` string, byte: Die Datei Base64-kodiert: eine XML-Datei oder ein ZIP mit mehreren XML-Dateien (max. 10 MB). Alternativ 'xml'.
  - `filename` string: Optionaler Dateiname, erscheint in den Meldungen.

## Response `200`

Ergebnis; billing nennt, womit bezahlt wurde.

- object
  - `summary` string, required: Kurzfassung des Ergebnisses.
  - `result` object, required
    - `files` object[], required
      - `name` string, required
      - `message` 'camt.052' | 'camt.053' | 'camt.054' | 'camt.086', required
      - `version` string, required
      - `header` object, required
      - `statements` object[], required
      - `totals` object[]: Nur camt.086: Summen je Preiswährung.
        - `currency` string
        - `services` integer
        - `net` number
        - `waived` number
        - `tax` number
        - `gross` number
      - `settlementTotals` object[]: Nur camt.086: Belastung in abweichender Abrechnungswährung.
        - `value` number
        - `currency` string
        - `services` integer
      - `parseFindings` object[], required
        - `code` string, required: Maschinencode der Prüfregel.
        - `severity` 'error' | 'warning' | 'info', required
        - `message` string, required: Deutsche Meldung.
        - `path` string: Punkt-Pfad in das gelesene Modell.
    - `skipped` object[], required: Dateien im ZIP-Archiv, die keine unterstützte camt-Datei sind.
      - `name` string, required
      - `reason` string, required
    - `billing` object, required: Womit der Aufruf bezahlt wurde: free_quota (Freikontingent), subscription (Zahlungsverkehr-Abo), check_block (Prüfblock: 1 Credit für 10 Prüfungen) oder credit (Guthaben).
      - `via` 'free_quota' | 'subscription' | 'check_block' | 'credit', required
      - `freeRemaining` integer, nullable, required: Verbleibende kostenlose Aufrufe im laufenden Zeitraum (Europe/Berlin); beim Abo null.
      - `freePeriod` 'day' | 'month', required: Zeitraum des Freikontingents: day beim Prüfen, month beim Auslesen.
      - `checkBlockRemaining` integer: Nur bei via check_block: offene Prüfungen im Prüfblock nach diesem Aufruf.
      - `creditsCharged` integer: Abgebuchte Credits: bei via credit und beim Kauf eines neuen Prüfblocks.
      - `refunded` boolean: true, wenn der Aufruf zurückgebucht wurde, weil die Schemaprüfung nicht erreichbar war.

## Other responses

- `400`: Keine Datei, kein unterstütztes Format oder eine nicht unterstützte Version (code invalid_input). Abgewiesene Dateien kosten nichts.
- `401`: Kein oder ungültiges Credential.
- `402`: Monatskontingent (5 pro Monat) aufgebraucht, kein Zahlungsverkehr-Abo und kein Guthaben (code payment_required). Retry-After nennt die Sekunden bis zum Neubeginn des Kontingents (Monatsanfang, Europe/Berlin).
- `413`: Datei größer als 10 MB (code payload_too_large).
- `429`: Rate-Limit (30/min je Key).
- `502`: Fehler im nachgelagerten Dienst.

---

[API](https://skmtc.dev/finisma/apis/finisma-rest-api.md) · [All operations](https://skmtc.dev/finisma/apis/finisma-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/finisma/apis/finisma-rest-api/revisions/c1a9acfab69b?raw)