---
title: How to List Policies Attached to a Role
url: https://docs.vultr.com/platform/iam/roles/how-to-list-policies-attached-to-a-role
description: List all policies attached to a specific IAM role on Vultr. Review the permission rules that users and groups inherit when assigned to this role via the API.
publish_date: 2026-03-24T19:52:42.898011Z
last_updated: 2026-06-01T21:29:45.697391Z
---

Listing the policies attached to a role allows you to review the permission rules that define what users and groups assigned to the role can do. This is useful for auditing access configurations and understanding the scope of a role's permissions.

This guide explains how to list policies attached 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 **Permission Policies** section.

        The table displays all policies attached to this role, including their name, type, and description.

=== "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 policies.

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

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

        The response contains the requested resources.