How to List Users with a Policy Attached

Updated on 08 April, 2026

List all users that have a specific IAM policy attached on Vultr. Identify which users have direct permissions from a given policy through the Vultr IAM API.


Listing users with a policy attached allows you to see which users have the permissions defined by that policy. This is useful for auditing access, reviewing policy scope, and identifying users affected by policy changes.

This guide explains how to list users with a policy attached using the Vultr Console and the Vultr API.

  • Vultr Console
  • Vultr API
  1. Log in to the Vultr Console.

  2. Click the organization name in the top navigation bar.

  3. Click Manage Organization.

  4. Click the Permission Policies tab.

  5. Click the name of the policy you want to inspect.

  6. Expand the Attached Entities section.

    The table displays all users and groups attached to this policy, including their name, type, and status.

  1. Send a GET request to the List Policies endpoint to retrieve all policies in your organization.

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

    Note the id of the policy for which you want to list users.

  2. Send a GET request to the List Users with Policy endpoint to retrieve all users assigned to the policy. Replace {policy-id} with the id of the policy.

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

    The response contains the requested resources.

Comments