> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revolvie.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lesezugang einrichten

> API-Schlüssel erstellen und Transaktionen abrufen.

## 1. API-Schlüssel erstellen

<Steps>
  <Step title="Organisation öffnen">
    Melde dich in [revolvie](https://app.revolvie.com) an und öffne **Organisation → Integrationen**. Dort findest du
    den Bereich **API-Zugang**. Schlüssel erstellen können nur Administratoren deiner Organisation.
  </Step>

  <Step title="Schlüssel anlegen">
    Klicke auf **Neuen API-Schlüssel erstellen**, gib einen Namen ein (z. B. „Power App
    Zahlungsabgleich") und lass **Transaktionen lesen** eingeschaltet.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Tenant-ID kopieren">
    Im selben Bereich steht deine **Tenant-ID** mit Kopier-Knopf. Sie gehört in jeden API-Pfad.
  </Step>
</Steps>

<Tip>
  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).
</Tip>

## 2. Transaktionen abrufen

```bash theme={null}
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):

```json theme={null}
[
  {
    "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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.