---
title: "Listet die Belege des Betriebs, neueste zuerst"
method: GET
path: "/api/v1/rechnungen"
---

# Listet die Belege des Betriebs, neueste zuerst

`GET /api/v1/rechnungen`

## Request

- Base URL: `https://rechnungslotse.de`
- URL: `https://rechnungslotse.de/api/v1/rechnungen`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://rechnungslotse.de/authorize`, token URL `https://rechnungslotse.de/api/oauth/token`, scopes: `lesen`)

Listet die Belege des Betriebs, neueste zuerst. Filter: `status` (draft, open, paid, overdue, cancelled), `von` und `bis` über das Rechnungsdatum, `suche` in Nummer und Empfängername, `limit` (1–100, Vorgabe 25). Mit `faellig=1` kommen stattdessen die überfälligen, älteste zuerst.

## Response `200`

200 mit `invoices` – Nummer, Zustand, Datum, Fälligkeit, Brutto, bereits gezahlt, offener Rest und `overdue` (kalendarisch gerechnet, nicht am gespeicherten Zustand). Bei `faellig=1` zusätzlich `daysOverdue`, die bereits verschickten Mahnstufen und die nächste fällige.

- object

## Other responses

- `401`: Kein oder ungültiger Zugangsschlüssel: api_schluessel_ungueltig, api_schluessel_abgelaufen
- `403`: Recht „lesen“ fehlt am Schlüssel.
- `429`: Ratengrenze oder Kontingent: quota_exhausted, rate_limited. Retry-After sagt, wann.
- `503`: Prüfdienst nicht erreichbar – später wiederholen.

---

[API](https://skmtc.dev/rechnungslotse/apis/rechnungslotse-schnittstelle-v1.md) · [All operations](https://skmtc.dev/rechnungslotse/apis/rechnungslotse-schnittstelle-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/rechnungslotse/apis/rechnungslotse-schnittstelle-v1/revisions/0997b13254c2?raw)