---
title: How to List Role Trusts for a Specific Role
url: https://docs.vultr.com/platform/iam/roles/role-trusts/how-to-list-role-trusts-for-a-specific-role
description: List all trust relationships configured for a specific IAM role on Vultr. View which users, groups, organizations, or OIDC issuers can assume the role.
publish_date: 2026-03-24T19:52:25.409662Z
last_updated: 2026-04-08T16:03:11.431156Z
---

Listing role trusts for a specific role allows you to see all trust relationships configured for that role, including which users, groups, or OIDC issuers can assume it and under what conditions.

This guide explains how to list role trusts for a specific role using the 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 trusts.

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

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

    The response contains the requested resources.