Kunden-IPs (Organisation) auflisten

GET /api/customer-ips

Query Parameter

• organizationId (optional): Standard ist deine Session-Organisation
• customerId (optional): akzeptiert die Public-ID des Kunden als UUID (empfohlen) oder eine Legacy-numerische Kunden-ID
• search (optional)
• page (optional, Default 1)
• perPage (optional, Default 50, max 200)

Optional bedeutet hier: Parameter komplett weglassen, wenn du sie nicht nutzt. Sende keine leeren Strings wie page= oder perPage=.

Beispiel (cURL)

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

curl -X GET "$BASE_URL/api/customer-ips?organizationId=1&page=1&perPage=50" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Beispiel-Antwort

{
  "items": [],
  "total": 0,
  "page": 1,
  "perPage": 50
}

Häufige Fehler

• 400 Organization ID required wenn keine Organisation abgeleitet werden kann
• 400 Query-Validierungsfehler (z.B. ungültige organizationId, customerId, page, perPage)
• 401 Unauthorized wenn du nicht angemeldet bist
• 403 Forbidden wenn du keinen Zugriff auf die Organisation hast