---
title: How to List Users Assigned to a Role
url: https://docs.vultr.com/platform/iam/roles/how-to-list-users-assigned-to-a-role
description: List all users assigned to a specific IAM role on Vultr. View which users directly inherit the permissions defined by the role's attached policies via the API.
publish_date: 2026-03-24T19:52:43.760989Z
last_updated: 2026-06-01T21:29:48.138176Z
---

Listing users assigned to a role allows you to see which users have the permissions defined by that role. This is useful for auditing access, reviewing role membership, and identifying users affected by role changes.

This guide explains how to list users assigned to a role using the Vultr Console and the Vultr API.

=== "Vultr Console"

    1. Log in to the [Vultr Console](https://console.vultr.com).
    1. Click the organization name in the top navigation bar.
    1. Click **Manage Organization**.
    1. Click the **Roles** tab.
    1. Click the name of the role you want to inspect.
    1. Expand the **Attached Entities** section.

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

=== "Vultr API"

    1. Send a `GET` request to the [**List Roles** endpoint](https://www.vultr.com/api/#tag/iam/operation/list-iam-roles) to retrieve all roles in your organization.

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

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

    1. Send a `GET` request to the [**List Users with Role** endpoint](https://www.vultr.com/api/#tag/iam/operation/list-iam-role-users) to retrieve all users assigned to the role. Replace `{role-id}` with the id of the role.

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

        The response contains the requested resources.