---
title: How to List Groups Assigned to a Role
url: https://docs.vultr.com/platform/iam/roles/how-to-list-groups-assigned-to-a-role
description: List all groups assigned to a specific IAM role on Vultr. Identify which groups and their members inherit the permissions from the role through the IAM API.
publish_date: 2026-03-24T19:52:42.049340Z
last_updated: 2026-06-01T21:29:42.922376Z
---

Listing groups assigned to a role allows you to see which groups have the permissions defined by that role. This is useful for auditing access configurations and understanding the scope of a role's impact across your organization.

This guide explains how to list groups 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.
    1. Click the **Group** tab to filter by groups.

        The table displays all 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 groups.

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

        ```console
        $ curl "https://api.vultr.com/v2/roles/{role-id}/groups" \
            -X GET \
            -H "Authorization: Bearer ${VULTR_API_KEY}"
        ```
        The response contains the requested resources.