Kunden-Details abrufen
Gibt Details eines bestimmten Kunden zurück.
GET /api/customers/:customerPublicId
packageDisplayName ist das konfigurierte Anzeigename-Label des zugewiesenen Organisations-Pakets. Es ist kein global normalisierter Enum und kann deshalb organisationsspezifische Namen wie aquisition_test enthalten.
Antwort (Response)
{
"id": 101,
"publicId": "6bfec6f6-245a-47ce-843b-157d97d56f88",
"organizationId": 1,
"name": "Kunde A GmbH",
"email": "kontakt@kunde-a.de",
"notificationPhoneNumber": "+491701234567",
"notificationEmail": "alerts@kunde-a.de",
"packageId": 3,
"packageType": "growth",
"packageDisplayName": "Growth",
"status": "active",
"customFields": {
"interneReferenz": "KD-999"
},
"monthlyReportsEnabled": true,
"companyName": "Nordwind ApS",
"emailLanguage": "en",
"notificationChannels": null,
"notificationTargets": null,
"notificationRules": null,
"smsUsageCurrentMonth": 0,
"allowSelfService": null,
"maxSelfServiceUrls": null,
"canEditManaged": false,
"enableEmailAlerts": null,
"enableSmsAlerts": null,
"enableWebhookAlerts": null,
"enableIntegrationAlerts": null,
"enablePostRequestEscalation": null,
"updatedAt": "2023-05-15T10:00:00Z",
"createdAt": "2023-05-15T10:00:00Z"
}packageType und Berechtigungs-Overrides: packageType ist der rohe Paket-Key des Kunden (der Wert, auf den packageType im Request-Body aufgelöst wird). Die Berechtigungs-Overrides (allowSelfService, maxSelfServiceUrls, canEditManaged, enableEmailAlerts, enableSmsAlerts, enableWebhookAlerts, enableIntegrationAlerts, enablePostRequestEscalation; null = vom Paket erben) stehen nur für Aufrufer in der Antwort, die sie auch schreiben dürfen: ein Organisations-Admin mit unbeschränktem Kundenbereich. Für einen kundengebundenen Token, jeden Nutzer ohne Admin-Rolle (editor, readonly) oder einen Global Supporter fehlen die Felder.
Häufige Fehler
400Invalid Customer identifier401Unauthorized404Customer not found (customerNotFound): Den Kunden gibt es nicht, er gehört zu einer anderen Organisation oder liegt außerhalb deines Kunden-Scopes. Bis zum 20.10.2026 antwortete der letzte Fall mit403.