---
title: ""
---

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

## Example (cURL)

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

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

## Response

Returns an array of customer IP objects. Each item may include a `dnsbl` object.

## 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