Skip to Content
Uptimeify Docs

Rechnungen auflisten

Listet alle Rechnungen für die Organisation auf.

GET /api/mollie/invoices

Query-Parameter

ParameterTypStandardBeschreibung
envelopestringkeineritems: 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/invoices bleibt 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 pdfUrl antwortet mit 502 (data.code: invoiceProviderFailed), wenn der Buchhaltungsanbieter einen Fehler meldet oder nicht erreichbar ist, und mit 404 (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 session wenn aus Session/Token keine Organisation abgeleitet werden kann
  • 401 Unauthorized wenn du nicht angemeldet bist
  • 403 Not authorized wenn du keinen Zugriff auf die Organisation hast
  • 403 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

Auf dieser Seite