Uptimeify Docs
MonitorsDnsbl monitoring

List Customer IPs (Org)

Lists customer IPs within an organization (pagination + search). This is the primary API for DNSBL monitoring configuration.

GET /api/customer-ips

Query Parameters

  • organizationId (optional): defaults to your session organization
  • customerId (optional): accepts the customer public UUID (recommended) or a legacy numeric customer ID
  • search (optional)
  • page (optional, default 1)
  • perPage (optional, default 50, max 200)

Example (cURL)

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

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

Example Response

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

Common errors

  • 400 Organization ID required when the organization cannot be derived
  • 400 query validation errors (e.g. invalid organizationId, customerId, page, perPage)
  • 401 Unauthorized when you are not logged in
  • 403 Forbidden when you cannot access the organization

On this page