Rechnungen auflisten
Listet alle Rechnungen für die Organisation auf.
GET /api/mollie/invoices
Query-Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
envelope | string | keiner | items: Antwort als { items, total, page, perPage }. Ab 18.01.2027 Standard. |
Beispiel (cURL)
BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"
curl -X GET \
"$BASE_URL/api/mollie/invoices?envelope=items" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"Hinweise:
- Die Organisation wird automatisch aus deiner authentifizierten Session bzw. deinem API-Token abgeleitet.
- Die Legacy-Route
GET /api/organizations/:organizationPublicId/mollie/invoicesbleibt aus Kompatibilitätsgründen weiterhin verfügbar. - Die
pdfUrl-Werte in der Response verwenden die org-lose Download-Route/api/invoices/:invoiceId/pdf. - Der Download eines PDFs über
pdfUrlantwortet mit502(data.code: invoiceProviderFailed), wenn der Buchhaltungsanbieter einen Fehler meldet oder nicht erreichbar ist, und mit404(data.code: invoiceNotFound), wenn es die Rechnung nicht gibt. Beides liegt nicht an deiner Sitzung, melde dich deshalb nicht ab. - Global Admins brauchen für die org-lose Route einen aktiven Organisationskontext in der Session.
Antwort (Response)
{
"items": [
{
"id": "inv_123456",
"reference": "RE-2024-001",
"status": "paid",
"issuedAt": "2024-01-15T10:00:00.000Z",
"netAmount": {
"value": "29.99",
"currency": "EUR"
},
"pdfUrl": "/api/invoices/inv_123456/pdf"
},
{
"id": "inv_123455",
"reference": "RE-2023-128",
"status": "paid",
"issuedAt": "2023-12-15T10:00:00.000Z",
"netAmount": {
"value": "29.99",
"currency": "EUR"
},
"pdfUrl": "/api/invoices/inv_123455/pdf"
}
],
"total": 2,
"page": 1,
"perPage": 2
}Listenform: Mit envelope=items kommt die Liste als { items, total, page, perPage }. Ohne den Parameter antwortet der Endpunkt noch in der bisherigen Form ({ "invoices": [...] }); sie ist veraltet, ab dem 18.01.2027 ist { items, ... } der Standard.
Häufige Fehler
400 Organization ID is required in the authenticated sessionwenn aus Session/Token keine Organisation abgeleitet werden kann401 Unauthorizedwenn du nicht angemeldet bist403 Not authorizedwenn du keinen Zugriff auf die Organisation hast403 Only organization admins can view invoices(data.code: forbidden) für Editoren, Readonly-Nutzer und Responder der Organisation; Rechnungen tragen Rechnungsadresse, USt-ID und Beträge
Datenexporte auflisten
Gibt die letzten Datenexport-Anfragen deiner Organisation mit Status, Größe, Retention-Fenster und Ablaufdatum zurück.
Paket-Konfigurationen auflisten
Gibt alle Paket-Konfigurationen der Organisation aus deiner authentifizierten Session zurück. Jede Konfiguration enthält zusätzlich usedByCustomerCount.