Skip to Content
Uptimeify Docs
MonitorsDnsbl monitoring

List Customer IPs (Customer)

title: List Customer IPs (Customer) description: GET /api/customers/:customerPublicId/ips

List Customer IPs (Customer)

GET /api/customers/:customerPublicId/ips

Lists IPs for a single customer, including DNSBL status.

Path Parameters

  • customerPublicId (recommended): Customer public UUID
  • Legacy compatibility: numeric customer IDs are still accepted

Query Parameters

ParameterTypeDefaultDescription
envelopestringnoneitems: answer as { items, total, page, perPage }. Becomes the default on 2027-01-18.

Example (cURL)

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

curl -X GET "$BASE_URL/api/customers/6bfec6f6-245a-47ce-843b-157d97d56f88/ips?envelope=items" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Response

Returns the customer's IP objects; each item may include a dnsbl object.

List form: with envelope=items the list arrives as { items, total, page, perPage }. Without it the endpoint still answers the current form (a bare array of the same items), which is deprecated; { items, ... } becomes the default on 2027-01-18.

Common errors

  • 400 Invalid Customer identifier when :customerPublicId is missing/invalid
  • 401 Unauthorized when you are not logged in
  • 403 Forbidden when you cannot access the customer
  • 404 Customer not found when the customer does not exist

On this page