MonitorsDnsbl monitoring
Get Customer IP
Returns a customer IP including DNSBL status (if available).
GET /api/customer-ips/:customerIpPublicId
The response contains the customer IP itself and, if available, a dnsbl object. It does not embed the full customer record.
Path Parameters
customerIpPublicId(recommended): customer IP public UUID- Backward compatibility: legacy numeric IDs are still accepted
Example (cURL)
BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"
curl -X GET "$BASE_URL/api/customer-ips/11111111-1111-4111-8111-111111111111" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"Example response
{
"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
}
}Common errors
400 Invalid IP identifierwhen:customerIpPublicIdis neither a valid UUID nor a legacy numeric ID401 Unauthorizedwhen you are not logged in403 Forbiddenwhen you cannot access the customer404 IP not foundwhen the IP does not exist