> ## 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.

# Fehler und Limits

> Statuscodes, Rate Limit und was bei Fehlern zu tun ist.

## Statuscodes

| Code | Bedeutung | Was tun |
| - | - | - |
| `200` | Erfolg | – |
| `401` | Schlüssel fehlt, ist unbekannt, widerrufen oder abgelaufen | Header `X-API-KEY` prüfen, ggf. neuen Schlüssel erstellen |
| `403` | Schlüssel gehört zu einem anderen Mandanten oder hat die Berechtigung nicht | Tenant-ID im Pfad und Berechtigungen des Schlüssels prüfen |
| `405` | Methode nicht erlaubt – die API ist nur lesend | Nur `GET` verwenden |
| `422` | Ungültiger Parameter (z. B. Datum im falschen Format, `limit` über 1000) | Parameter laut Fehlermeldung korrigieren |
| `429` | Rate Limit erreicht | Wartezeit aus Header `Retry-After` (Sekunden) abwarten |

Fehler kommen als JSON mit einem Feld `detail`:

```json theme={null}
{ "detail": "Invalid or missing API key" }
```

## Rate Limit

Jeder API-Schlüssel darf **120 Anfragen pro Stunde** stellen (festes Stundenfenster). Danach antwortet
die API mit `429` und dem Header `Retry-After`, der angibt, wie viele Sekunden bis zum nächsten Fenster
bleiben.

Für einen täglichen Abgleich reichen ein bis zwei Aufrufe pro Tag; mit `from_date` lässt sich auf neue
Buchungen seit dem letzten Abruf einschränken.


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