# Get IP addresses to whitelist

`GET https://api.cryptohopper.com/v1/hopper/{id}/ipwhitelist`

Part of [Hoppers](https://www.cryptohopper.com/api-documentation/api-reference/hoppers.md) in the Cryptohopper API reference.

Returns the IP addresses to whitelist on the exchange for this hopper's API key: space separated, in the format the exchange expects, and comma separated for display.

OAuth scope: `read`

## Headers

| Name | Type | Required | Description |
|---|---|---|---|
| `access-token` | string | yes | The OAuth access token of the user. |

## Path parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `id` | string | yes | Hopper ID. |

## Query parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `exchange` | string | no | Exchange to return the addresses for, e.g. kucoin. Defaults to the exchange of the hopper; an unknown exchange is ignored. |

## Example request

```bash
curl "https://api.cryptohopper.com/v1/hopper/HOPPER_ID/ipwhitelist" \
  -H "access-token: YOUR_ACCESS_TOKEN"
```

## Response

Example response (illustrative values):

```json
{
    "data": {
        "ip_addresses": "203.0.113.10 203.0.113.11",
        "total": 2,
        "copy_ip_addresses": "203.0.113.10,203.0.113.11",
        "show_ip_addresses": "203.0.113.10, 203.0.113.11"
    }
}
```

Status codes: 200. Errors return JSON with `status`, `error` and `message`, plus a numeric `code` when the error comes from the API itself rather than the gateway.