---
title: How to List Roles and Policies Attached to a Group
url: https://docs.vultr.com/platform/iam/groups/how-to-list-roles-and-policies-attached-to-a-group
description: List all roles and policies attached to a specific IAM group on Vultr. Review the permissions inherited by group members through the Vultr IAM API endpoint.
publish_date: 2026-03-24T19:52:18.843212Z
last_updated: 2026-04-08T16:02:24.246679Z
---

Listing the roles and policies attached to a group allows you to review the permissions that all members of the group inherit. The API provides visibility into directly assigned permissions, those inherited from other sources, and permissions that come from roles attached to the group.

> [!NOTE]
> You must be the organization's root user or have `iam.group.*` permissions assigned to perform this action.

This guide explains how to list roles and policies attached to a group using the Vultr Console or 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 **Groups** tab.
    1. Click the name of the group you want to inspect.

        The group detail page displays the **Roles** and **Members** sections, showing all roles attached to the group and all users who are members. To view directly attached policies, navigate to the **Permission Policies** tab, select the policy, and view the group under **Attached Entities**.

=== "Vultr API"

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

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

    Note the `id` of the group for which you want to list roles and policies.

    ## List Roles

    Send a `GET` request to the [**List Group Roles** endpoint](https://www.vultr.com/api/#tag/iam/operation/list-iam-group-roles) to retrieve all roles attached to the group. Replace `{group-id}` with the id of the group.

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

    ## List Policies

    Send a `GET` request to the [**List Group Policies** endpoint](https://www.vultr.com/api/#tag/iam/operation/list-iam-group-policies) to retrieve all policies attached to the group.

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

    The response contains the requested resources.