---
title: "Kunden auflisten"
description: "Listet alle Kunden der Organisation auf."
---

`GET /api/customers`

## Query-Parameter

- `organizationId` (erforderlich): Die ID der Organisation.
- `fields` (optional): Auf `minimal` setzen, um eine schlanke Struktur mit ausschließlich `id`, `publicId`, `name`, `status` und `customFields` zu 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`:

```json
[
  {
    "id": 101,
    "publicId": "cus_9f3a…",
    "name": "Kunde A GmbH",
    "status": "active",
    "customFields": { "region": "EU" }
  }
]
```

Standard-Antwort:

```json
[
  {
    "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.