Excellent Banking API: Authentifizierung, Endpunkte und erste Anfrage

Wir freuen uns, eine neue Art der Arbeit mit Excellent Banking eröffnen zu können: eine REST API, mit der Sie Kontoauszüge direkt aus Ihren eigenen Anwendungen, Skripten oder Workflows parsen, kategorisieren und exportieren können.

Für Entwickler, Buchhalter mit mehreren Mandanten oder Unternehmen, die Auszüge in größerem Umfang verarbeiten müssen, entfällt durch die API das manuelle Hochladen über die Web-App. Alles läuft über einfache HTTP-Anfragen.

Was die API ermöglicht

Die API deckt im Wesentlichen dieselbe Verarbeitungspipeline ab, die Sie aus der Web-App kennen — jedoch vollständig automatisiert:

Laden Sie Auszüge programmatisch aus Ihrem Backend oder Ihren Automatisierungsskripten hoch
Stoßen Sie die Verarbeitung an und erhalten Sie strukturierte Transaktionsdaten als JSON
Laden Sie kategorisierte Excel-Dateien herunter, bereit für Buchhaltung, Analyse oder den Import in Ihre Tools
Prüfen Sie den Verarbeitungsstatus, um zuverlässige, ereignisgesteuerte Workflows aufzubauen

Sie behalten die volle Kontrolle. Die API trifft keine Entscheidungen für Sie — sie liefert Ihnen die strukturierte Ausgabe, und Sie entscheiden, was Sie damit machen.

Authentifizierung

Alle API-Aufrufe werden mit API-Schlüsseln authentifiziert. So funktioniert’s:

Holen Sie sich Ihren Schlüssel über Ihr Excellent Banking Dashboard. Jedes Konto erhält einen.
Fügen Sie ihn im Authorization-Header jeder Anfrage ein.
Wechseln Sie ihn bei Bedarf — Sie können jederzeit neue Schlüssel im Dashboard generieren. Alte Schlüssel werden sofort ungültig.

Das ist alles. Kein OAuth-Tanz, keine Token-Refresh-Logik, keine komplexe Session-Verwaltung. Ein Schlüssel, ein Header, und Sie sind drin.

Schlüssel sind auf Ihr Konto beschränkt, d.h. Sie können nur Ihre eigenen Dateien sehen und verwalten. Wenn Sie Zugriff auf Teamebene oder Service-Konten benötigen, kontaktieren Sie uns.

Die wichtigsten Endpunkte

Die API folgt REST-Konventionen. Hier ein konzeptioneller Überblick über die verfügbaren Ressourcen:

Ressource	Beschreibung
Kontoauszüge	Auszüge hochladen (PDF, CSV, Bild), Ihre Upload-Historie einsehen, Dateien löschen
Verarbeitung	Extraktion und Kategorisierung für eine hochgeladene Datei anstoßen
Ergebnisse	Verarbeitete Transaktionen als JSON abrufen, den Excel-Export herunterladen
Guthaben	Aktuelles Guthaben prüfen, Nutzungsverlauf einsehen
Konto	Profil und API-Schlüssel verwalten

Jede Antwort ist JSON. Jeder Endpunkt liefert klare Statuscodes, aussagekräftige Fehlermeldungen und bei Bedarf konsistente Paginierung.

Wir halten die Oberfläche klein und fokussiert. Das Ziel sind wenige, gut gestaltete Endpunkte, die echte Workflows abdecken — kein unübersichtlicher Katalog, in dem man sich verirrt.

Ihre erste Anfrage

So sieht ein typischer Integrationsablauf aus:

Authentifizieren — Ihren API-Schlüssel im Anfrage-Header mitsenden
Hochladen — eine Kontoauszugsdatei (PDF, CSV oder Bild) über eine einzige Multipart-Anfrage senden
Status prüfen — die Verarbeitung läuft asynchron. Pollen Sie den Status-Endpunkt oder warten Sie auf Benachrichtigungen
Ergebnisse abrufen — sobald die Verarbeitung abgeschlossen ist, erhalten Sie strukturierte Transaktionsdaten als JSON
Exportieren — bei Bedarf eine Excel-Datei anfordern

Der gesamte Ablauf besteht aus drei Anfragen: hochladen, Status prüfen, Ergebnisse abrufen. Wenn Sie eine Excel-Tabelle wünschen, kommt eine vierte Anfrage für den Export hinzu.

Ausführliche Codebeispiele für Python, JavaScript und cURL finden Sie in der API-Dokumentation. Die Dokumentation enthält interaktive Request-Builder, mit denen Sie Endpunkte direkt im Browser testen können, bevor Sie Code schreiben.

Preise für die API-Nutzung

API-Aufrufe verbrauchen Credits aus demselben Guthaben, das Sie auch in der Web-App nutzen. Es gibt keine separaten API-Preise und keine zusätzliche verbrauchsabhängige Abrechnung:

Ein verarbeiteter Auszug = ein bis zwei Credits (je nach Umfang)
Dieselben Credit-Pakete, die Sie bereits kennen: 5 € für 50, 20 € für 200, 50 € für 700
Credits verfallen nie, egal ob Sie sie in der App oder über die API nutzen
Prüfen Sie Ihr Guthaben jederzeit über den Credits-Endpunkt

Das bedeutet, Sie können beliebig kombinieren — einige Auszüge über die Web-Oberfläche hochladen, den Rest über die API automatisieren. Dasselbe Konto, dieselben Credits, keine Überraschungen.

Datenschutz und Datenverarbeitung

Dieselben Datenschutzgarantien, die für die Web-App gelten, erstrecken sich auch auf die API:

Alle Daten bleiben in der EU (Deutschland und Schweiz)
Vollständige DSGVO-Konformität
Ihre Daten werden niemals für Training verwendet
Vollständige Löschung auf Anfrage jederzeit möglich
API-Schlüssel werden ausschließlich über HTTPS übertragen

Wenn Sie Integrationen entwickeln, die Bankdaten verarbeiten, können Sie sich darauf verlassen, dass unsere Infrastruktur die europäischen Datenschutzstandards erfüllt.

Wie geht’s weiter mit der API?

Dies ist die erste Version der API, und wir verbessern sie aktiv basierend auf Feedback. Auf der kurz- bis mittelfristigen Roadmap:

Webhooks, damit Ihre Integration den Status nicht pollen muss
Batch-Verarbeitung für das Einreichen mehrerer Auszüge in einem Aufruf
Weitere Ausgabeformate über Excel und JSON hinaus
Benutzerdefinierte Kategorisierungsregeln, die Sie über die API anwenden können

Die API wächst mit Ihren Anforderungen. Wenn Sie ein bestimmtes Feature oder einen Endpunkt nützlich fänden, lassen Sie es uns wissen.

Los geht’s

Besuchen Sie Ihr Dashboard, holen Sie sich Ihren API-Schlüssel und schauen Sie in die vollständige Dokumentation. Ihre erste Anfrage ist nur wenige Minuten entfernt.

Falls Sie Fragen haben oder auf Probleme stoßen, erreichen Sie uns unter hello@excellent-banking.com.