---
title: How to List Groups with a Policy Attached
url: https://docs.vultr.com/platform/iam/policies/how-to-list-groups-with-a-policy-attached
description: List all groups that have a specific IAM policy attached on Vultr. Identify which groups inherit permissions from a given policy through the Vultr IAM API.
publish_date: 2026-03-24T19:52:10.990741Z
last_updated: 2026-06-01T21:19:37.482466Z
---

Listing groups with a policy attached allows you to see which groups have the permissions defined by that policy. This is useful for auditing access configurations and understanding how a policy's permissions are distributed across your organization.

This guide explains how to list groups with a policy attached 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 **Permission Policies** tab.
    1. Click the name of the policy you want to inspect.
    1. Expand the **Attached Entities** section.

        The table displays all users and groups attached to this policy, including their name, type, and status. Groups are identified by the **Group** type label.

=== "Vultr API"

    1. Send a `GET` request to the [**List Policies** endpoint](https://www.vultr.com/api/#tag/iam/operation/list-iam-policies) 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 groups.

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

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

        The response contains the requested resources.