Transaktionen per API filtern

Mit Filtern holst du genau die Transaktionen ab, die deine Anwendung braucht. Alle Beispiele verwenden die öffentliche API mit /v1/WORKSPACE_ID und einem Bearer-Schlüssel.

Konto und Zeitraum wählen

Für ein bestimmtes Konto verwendest du:

GET /v1/WORKSPACE_ID/accounts/KONTO_ID/transactions

Für einen Zeitraum kannst du diese Parameter ergänzen:

Die Grenzen werden einschließlich ausgewertet. Verwende vollständige Zeitangaben mit Zeitzone, wenn du einen Zeitraum genau abgrenzen möchtest. Ein reines Datum wie 2026-08-31 steht für den Tagesbeginn, nicht für das Ende dieses Tages.

Dieses Beispiel liest Buchungen im August 2026 nach UTC. KONTOFLUX_WORKSPACE_ID und KONTOFLUX_API_KEY stehen für Umgebungsvariablen deiner Anwendung:

curl --fail-with-body --get \
  "https://api.kontoflux.io/v1/${KONTOFLUX_WORKSPACE_ID}/transactions" \
  --header "Authorization: Bearer ${KONTOFLUX_API_KEY}" \
  --data-urlencode 'bookedAfter=2026-08-01T00:00:00.000Z' \
  --data-urlencode 'bookedBefore=2026-08-31T23:59:59.999Z' \
  --data-urlencode 'limit=50'

Kategorien filtern

Mit category filterst du nach der Kategorie einer Transaktion. Du kannst eine Kategorie-ID oder einen exakten Kategorienamen übergeben. Die gültigen Werte liest du über /categories.

parentCategory eignet sich für eine übergeordnete Kategorie. Der Filter berücksichtigt sie auch dann, wenn die Transaktion direkt dieser Hauptkategorie zugeordnet ist. Verwende für einfache Abfragen jeweils den passenden einzelnen Kategorienfilter.

Suchen oder Referenzen abgleichen

Verwende zum Beispiel /transactions/match?query=RE-2026-1042 für eine Rechnungsreferenz. Die Ergebnisse enthalten einen score, der die Übereinstimmung bewertet. Er ist keine Bestätigung, dass eine Rechnung bezahlt ist. Prüfe zusätzlich Betrag, Währung, Richtung und mögliche Mehrfachtreffer.

Für /match kannst du mit threshold zwischen 0 und 1 die Mindestbewertung festlegen. Der Standardwert ist 0.60. Ein höherer Wert lässt weniger Treffer zu. Der Abgleich verwendet Referenz- und Textmerkmale; aus dem Score lässt sich keine Zahlungswahrscheinlichkeit ableiten.

Konto- und Datumsfilter helfen auch beim Referenzabgleich, den Suchbereich einzugrenzen. Die Varianten für ein einzelnes Konto enden entsprechend auf /accounts/KONTO_ID/transactions/search oder /accounts/KONTO_ID/transactions/match.

Weitere Ergebnisse laden

Listen liefern ein JSON-Array. Mit limit bestimmst du die Seitengröße, mit offset überspringst du bereits geladene Ergebnisse.

Bei limit=50 rufst du nacheinander offset=0, offset=50, offset=100 ab. Im Antwortheader X-Total-Count findest du die Gesamtzahl der passenden Ergebnisse. Behalte beim Weiterblättern dieselben Filter bei.

Alle Parameter und Antwortfelder findest du in der API-Referenz.