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
| Parameter | Type | Default | Description |
|---|---|---|---|
envelope | string | none | items: 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 identifierwhen:customerPublicIdis missing/invalid401 Unauthorizedwhen you are not logged in403 Forbiddenwhen you cannot access the customer404 Customer not foundwhen the customer does not exist