---
title: List IP Addresses
url: https://docs.vultr.com/platform/other/users/manage-users/api-access/ip-address-whitelisting/list-ip-addresses
description: A guide explaining how to retrieve the IP whitelist associated with a specific user account on Vultr
publish_date: 2025-07-05T11:59:29.242776Z
last_updated: 2026-04-15T18:11:17.784023Z
---

# How to Get the IP Whitelist for a User

Retrieving the IP whitelist for a user allows authorized administrators to review which public IP addresses are permitted to access the Vultr account. This operation is restricted to root users or those with the `manage_users` permission, ensuring that only privileged roles can manage access controls. The whitelist supports only public IPs—private addresses are not accepted—and enforces valid subnet sizes: `/8` to `/32` for IPv4 and `/20` to `/128` for IPv6. Additionally, the API is idempotent, meaning adding the same IP multiple times has no adverse effect, which simplifies automation and scripting.

Follow this guide to get the IP whitelist for a user using the Vultr API.

1. Send a `GET` request to the [**Get Users** endpoint](https://www.vultr.com/api/#tag/users/operation/list-users) to view all users and note the user id for the target user.

    ```console
    $ curl "https://api.vultr.com/v2/users" \
        -X GET \
        -H "Authorization: Bearer ${VULTR_API_KEY}"
    ```

1. Send a `GET` request to the [**List User IP Whitelist** endpoint](https://www.vultr.com/api/#tag/users/operation/list-user-ip-whitelist) to list all whitelisted IP addresses for a user's whitelist.

    ```console
    $ curl "https://api.vultr.com/v2/users/{user-id}/ip-whitelist" \
        -X GET \
        -H "Authorization: Bearer ${VULTR_API_KEY}"
    ```