Kunden auflisten
Listet alle Kunden der Organisation auf.
GET /api/customers
Query-Parameter
organizationId(erforderlich): Die ID der Organisation.fields(optional): Aufminimalsetzen, um eine schlanke Struktur mit ausschließlichid,publicId,name,statusundcustomFieldszu erhalten. Monitor-Zähler und Paketdetails entfallen, und die Antwort ist deutlich kleiner. Nützlich zum Befüllen von Auswahllisten/Dropdowns.
Antwort (Response)
Mit fields=minimal:
[
{
"id": 101,
"publicId": "cus_9f3a…",
"name": "Kunde A GmbH",
"status": "active",
"customFields": { "region": "EU" }
}
]Standard-Antwort:
[
{
"id": 101,
"organizationId": 1,
"name": "Kunde A GmbH",
"email": "kontakt@kunde-a.de",
"packageId": 4,
"packageDisplayName": "Business",
"status": "active",
"cancellationDate": null,
"notificationEmail": "alerts@kunde-a.de",
"createdAt": "2023-05-15T10:00:00Z"
},
{
"id": 102,
"organizationId": 1,
"name": "StartUp XY",
"email": "info@startup-xy.com",
"packageId": 1,
"packageDisplayName": "Essential",
"status": "marked_for_cancellation",
"cancellationDate": "2024-12-31T23:59:59Z",
"createdAt": "2023-06-20T14:30:00Z"
}
]Hinweis: Die Listen-Response liefert absichtlich keinen rohen packageType mehr. Verwende packageDisplayName für Anzeigezwecke und packageId für technische Zuordnung. packageDisplayName stammt aus der zugewiesenen Organisations-Paketkonfiguration und kann deshalb organisationsspezifisch sein.