---
title: "List Customer IPs (Org)"
description: "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)

```bash
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

```json
{
  "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