Lesezugang einrichten

1. API-Schlüssel erstellen

Organisation öffnen

Melde dich in revolvie an und öffne Organisation → Integrationen. Dort findest du den Bereich API-Zugang. Schlüssel erstellen können nur Administratoren deiner Organisation.

Schlüssel anlegen

Klicke auf Neuen API-Schlüssel erstellen, gib einen Namen ein (z. B. „Power App Zahlungsabgleich”) und lass Transaktionen lesen eingeschaltet.

Schlüssel sicher speichern

Der Schlüssel beginnt mit rvk_ und wird nur einmal angezeigt. revolvie speichert ihn nicht im Klartext und kann ihn später nicht erneut anzeigen. Geht er verloren, widerrufe ihn und erstelle einen neuen.

Tenant-ID kopieren

Im selben Bereich steht deine Tenant-ID mit Kopier-Knopf. Sie gehört in jeden API-Pfad.

Gib den Schlüssel nur an die Person oder das System weiter, das ihn braucht, und speichere ihn wie ein Passwort (z. B. in einem Secret-Store, nicht im Quellcode).

2. Transaktionen abrufen

curl "https://api.revolvie.com/v1/public/<TENANT_ID>/transactions?from_date=2026-10-01&to_date=2026-10-31" \
  -H "X-API-KEY: rvk_..."

Antwort (gekürzt):

[
  {
    "id": "6f1c2b9e-0c1d-4f7a-9a3e-2d5b8c4e1a00",
    "date": "2026-10-14",
    "amount": 1190.0,
    "text": "Rechnung 2026-0042",
    "iban": "DE00000000000000000000",
    "contra_iban": "DE11111111111111111111",
    "contra_name": "Beispiel GmbH",
    "status": "unassigned"
  }
]

Positive Beträge sind Eingänge, negative Ausgänge.
text ist der Verwendungszweck – das Feld für den Abgleich mit Rechnungsnummern.
status zeigt, ob die Buchung in revolvie schon zugeordnet ist (assigned, partly assigned, unassigned).

3. Filter und Seiten

Parameter	Bedeutung	Standard
`from_date`	Buchungsdatum ab (inklusive), `YYYY-MM-DD`	–
`to_date`	Buchungsdatum bis (inklusive), `YYYY-MM-DD`	–
`status`	Zuordnungsstatus, mehrfach möglich: `?status=unassigned&status=partly%20assigned`	alle
`limit`	Anzahl pro Seite, 1–1000	100
`offset`	Anzahl übersprungener Einträge	0

Sortiert wird nach Buchungsdatum, neueste zuerst. Die Gesamtzahl der Treffer steht im Antwort-Header X-Total-Count – damit lässt sich über offset blättern, bis alle Einträge geladen sind.

Schlüssel widerrufen

Unter Organisation → Integrationen → API-Zugang kannst du jeden Schlüssel mit Widerrufen sofort sperren. Die Liste zeigt auch, wann ein Schlüssel zuletzt verwendet wurde (auf die Minute genau). API-Schlüssel laufen nicht automatisch ab. Widerrufe Schlüssel, die nicht mehr gebraucht werden.

Erste Schritte

API-Referenz

1. API-Schlüssel erstellen

2. Transaktionen abrufen

3. Filter und Seiten

Schlüssel widerrufen

​1. API-Schlüssel erstellen

​2. Transaktionen abrufen

​3. Filter und Seiten

​Schlüssel widerrufen

1. API-Schlüssel erstellen

2. Transaktionen abrufen

3. Filter und Seiten

Schlüssel widerrufen