---
title: "Kunden-IP abrufen"
description: "Gibt eine Kunden-IP inkl. DNSBL-Status zurück (falls vorhanden)."
---

`GET /api/customer-ips/:customerIpPublicId`

Die Response enthält die Kunden-IP selbst und, falls vorhanden, ein `dnsbl`-Objekt. Ein vollständiger Kunden-Datensatz wird nicht eingebettet.
## Beispiel-Response

```json
{
  "id": 1,
  "publicId": "a19effb9-eb5f-459b-b5d6-2f615b574651",
  "customerId": 2,
  "customerName": "Zaskoku & Haupt GbR",
  "label": "Kurbelix Adminserver",
  "ipAddress": "77.75.254.185",
  "ipFamily": "v4",
  "status": "active",
  "createdAt": "2026-02-03T15:06:46.469Z",
  "updatedAt": "2026-02-03T15:06:46.469Z",
  "dnsbl": {
    "isListed": true,
    "listedCount": 1,
    "listings": [
      {
        "name": "all.s5h.net",
        "reason": "Listed in all.s5h.net",
        "listKey": "all.s5h.net",
        "delistUrl": "http://s5h.net",
        "resultCode": "127.0.0.2"
      }
    ],
    "lastError": null,
    "lastCheckedAt": "2026-04-03T15:13:00.083Z",
    "lastChangedAt": "2026-02-04T10:00:00.121Z",
    "lastListedAt": "2026-04-03T15:13:00.083Z",
    "lastCleanAt": null,
    "lastNotifiedListedAt": "2026-04-02T20:55:04.969Z",
    "lastNotifiedCleanAt": null
  }
}
```

## Pfadparameter

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

## Beispiel (cURL)

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

curl -X GET "$BASE_URL/api/customer-ips/11111111-1111-4111-8111-111111111111" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"
```

## Häufige Fehler

- `400 Invalid IP identifier` wenn `:customerIpPublicId` weder UUID noch Legacy-ID ist
- `401 Unauthorized` wenn du nicht angemeldet bist
- `403 Forbidden` wenn du keinen Zugriff auf den Kunden hast
- `404 IP not found` wenn die IP nicht existiert