# API im Überblick

Über die öffentliche API liest deine Anwendung die Daten deiner eigenen Bankkonten aus deinem Kontoflux.io-Workspace. Du kannst zum Beispiel Kontostände in einem eigenen Bericht anzeigen oder Transaktionen für einen Abgleich abrufen.

## Zugang wählen

| Anwendung | Zugang |
| --- | --- |
| Eigenes Skript oder serverseitiger Prozess | [API-Schlüssel](https://docs.kontoflux.io/api/zugang-zur-api/) |
| Anwendung, der du nach der Anmeldung Zugriff auf deine Bankdaten gibst | [OAuth-App](https://docs.kontoflux.io/integrationen/oauth-apps/) |
| KI-Client mit MCP-Unterstützung | [MCP-Server](https://docs.kontoflux.io/integrationen/mcp-server/) |

API-Zugänge sind an einen Workspace gebunden. Ihre Berechtigungen und Kontenauswahl bestimmen, welche Daten erreichbar sind.

## Aufbau der Adresse

```text
https://api.kontoflux.io/v1/WORKSPACE_ID/RESOURCE
```

Ersetze `WORKSPACE_ID` durch die Kennung deines Workspaces und `RESOURCE` durch den gewünschten Endpunkt. Die Workspace-Kennung ist beispielsweise der Teil direkt vor `/automations` in der Adresse der geöffneten Automationsseite.

| Endpunkt | Zweck |
| --- | --- |
| `/accounts` | Konten und Kontodaten abrufen |
| `/accounts/KONTO_ID/transactions` | Transaktionen eines Kontos abrufen |
| `/transactions` | Transaktionen des Workspaces abrufen |
| `/transactions/search` | Transaktionen mit einem Suchtext finden |
| `/transactions/match` | Passende Transaktionen zu einer Referenz suchen |
| `/categories` | Verfügbare Kategorien abrufen |
| `/key/scope` | Berechtigungen des verwendeten Zugangs prüfen |

## Ersten Abruf vorbereiten

1. Erstelle und aktiviere einen [API-Schlüssel](https://docs.kontoflux.io/api/zugang-zur-api/).
2. Wähle dessen Berechtigungen und Bankkonten.
3. Übernimm deine Workspace-Kennung.
4. Probiere einen kleinen Abruf mit den [Codebeispielen](https://docs.kontoflux.io/api/api-snippets/).
5. Ergänze [Filter und Seitennavigation](https://docs.kontoflux.io/api/transaktionen-filtern/), wenn du größere Datenmengen liest.

Die API liefert den bereits in Kontoflux.io vorhandenen Stand. Ein Datenabruf startet keine Bankanmeldung und keine Ninox-Synchronisation.

Die vollständige Beschreibung von Parametern und Antworten findest du in der [API-Referenz](https://api.kontoflux.io/).