---
title: "Kunden-Domain abrufen"
description: "Gibt eine einzelne Kunden-Domain zurück."
---

`GET /api/customer-domains/:customerDomainPublicId`

Die Response enthält die Kunden-Domain selbst und bettet keinen vollständigen Kunden-Datensatz ein.

## Pfadparameter

- `customerDomainPublicId` (empfohlen): Public-ID der Kunden-Domain als UUID
- Legacy-Kompatibilität: numerische IDs werden weiterhin akzeptiert

Hinweise:

- Einige Registries/TLDs (z.B. `.de`) veröffentlichen kein Ablaufdatum via RDAP.
  In diesem Fall kann `expiry.domainExpiresAt` `null` sein und `expiry.lastError` enthält ggf. eine erklärende Fehlermeldung.

## Beispiel (cURL)

```bash
BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"

curl -X GET "$BASE_URL/api/customer-domains/22222222-2222-4222-8222-222222222222" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"
```

## Beispiel-Response

```json
{
  "id": 20,
  "publicId": "d70884d9-4cef-4fe5-9b15-341b7dd9e196",
  "customerId": 2,
  "customerName": "Zaskoku & Haupt GbR",
  "label": "Primary Domain",
  "domainName": "cacheassist.io",
  "status": "active",
  "expiryWarningDays": 30,
  "expiryErrorDays": 7,
  "createdAt": "2026-04-03T15:28:40.602Z",
  "updatedAt": "2026-04-03T15:28:40.602Z",
  "expiry": {
    "domainExpiresAt": null,
    "domainRegistrar": null,
    "isExpired": false,
    "lastError": "RDAP query error for cacheassist.io: fetch failed",
    "lastCheckedAt": "2026-04-03T15:29:00.200Z",
    "lastChangedAt": null,
    "lastNotifiedWarningAt": null,
    "lastNotifiedErrorAt": null,
    "lastNotifiedExpiredAt": null
  }
}
```

## Häufige Fehler

- `400 Invalid Domain identifier` wenn `:customerDomainPublicId` fehlt/ungültig ist
- `401 Unauthorized` wenn du nicht angemeldet bist
- `403 Forbidden` wenn du keinen Zugriff auf die Domain/den Kunden hast
- `404 Domain not found` wenn die Domain nicht existiert