Skip to Content
Uptimeify Docs

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

  • 400 Invalid Customer identifier
  • 401 Unauthorized
  • 404 Customer 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 mit 403.

Auf dieser Seite