# Forderungsstände lesen (https://developer.bimetrics.de/reference/receivables/list-receivables)

`GET https://app.bimetrics.de/api/receivable/`

operationId: `listReceivables` · Berechtigung (Scope): `sales:read` · Bereich: Forderungen und Mahnungen

Liefert ausgestellte Rechnungen mit aktuellem Zahlungsstand, Korrekturkapazität und Aktionsfreigaben. Alle Geldwerte in EUR-Cent. Bei paymentKnown=false sind zahlungsabhängige Nullwerte keine bestätigten Nullbeträge; Mahnungen bleiben gesperrt.

Benötigt einen Schlüssel mit der Berechtigung `sales:read` oder `read`.

### Authentifizierung

`Authorization: Bearer bm_…` (alternativ `X-API-KEY: bm_…`, nie beide zugleich).

### Parameter

| Name | Ort | Pflicht | Typ | Beschreibung |
| --- | --- | --- | --- | --- |
| `limit` | query | nein | integer | Seitengröße; Standard 25, höchstens 100. |
| `offset` | query | nein | integer | Anzahl zu überspringender Treffer; Standard 0. |
| `search` | query | nein | string | Suche in Rechnungsnummer und Kundenname. |
| `sort` | query | nein | string | Sortierfeld createdAt (Standard), number, customerName, issueDate oder dueDate. Berechnete offene Beträge sind nicht sortierbar. |
| `direction` | query | nein | string | Sortierrichtung asc oder desc; Standard desc. Sortierung gilt vor der Seitenauswahl. |
| `dueState` | query | nein | string | Fälligkeitsfilter overdue, not_due oder all (Standard). Prüft ausschließlich das Fälligkeitsdatum, nicht den Zahlungsstand. |
| `review` | query | nein | string | Optional reminders: nur mahnfähige Rechnungen oder Klärfälle mit unbekanntem Zahlungsstand beziehungsweise offenem Betrag ohne Fälligkeitsdatum. Ausgestellte Stornos und bekannte ausgeglichene oder überzahlte Forderungen bleiben ausgeschlossen. Ebenso Rechnungen mit einer ausgestellten, nicht zurückgezogenen Mahnung, deren Zahlungsfrist heute oder später endet (Europe/Berlin). Entwürfe und abgelaufene Fristen verschieben die Prüfung nicht. Filtert vor Gesamtzahl und Seitenauswahl; ohne Parameter bleibt die vollständige Quellenauswahl erhalten. |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/receivable/" \
  -H "Authorization: Bearer $BIMETRICS_API_KEY"
```

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Erfolg. | `application/json`: InvoiceReceivablePage |
| 400 | Ungültige Anfrage, z. B. ein Parameter mit ungültigem Wert wie eine ID, die keine UUID ist; korrigieren statt wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |
| 401 | Kein gültiger Schlüssel: fehlt (`Unauthorized`), ist unbekannt, abgelaufen oder widerrufen oder wurde nicht in genau einem Header gesendet (`InvalidAPIKey`). Schlüssel prüfen, nicht wiederholen. Auch eine ID, die zu einer anderen Firma gehört, ergibt `401 Unauthorized`. | `application/json`: Error |
| 403 | Dem Schlüssel fehlt die Berechtigung für diese Route (`APIKeyPermissionDenied`), oder die Firma hat keinen aktiven Tarif mit API-Zugang, etwa in der Testphase oder nach Ende des Abos (`APIUnavailable`). | `application/json`: Error |
| 413 | Die Anfrage ist zu groß (`APIRequestTooLarge`), siehe `x-bimetrics-limits`. | `application/json`: Error |
| 429 | Zu viele Anfragen; nach `Retry-After` Sekunden erneut senden. Mehr unter [Fehler](https://developer.bimetrics.de/errors). (Header: Retry-After) | `application/json`: Error |
| 500 | Serverfehler; die Anfrage später wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |

#### Felder der Antwort 200 (`InvoiceReceivablePage`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `items` | Array<InvoiceReceivable>, kann null sein | Forderungsstände dieser Seite. |
| `total` | integer | Gesamtzahl aller Treffer. |

Verschachtelte Schemas stehen vollständig in der OpenAPI-Beschreibung: https://app.bimetrics.de/api/openapi.json