---
title: How to List All Groups in Your Organization
url: https://docs.vultr.com/platform/iam/groups/how-to-list-all-groups-in-your-organization
description: Retrieve a list of all IAM groups in your Vultr organization. View group details including names, member counts, and associated roles through the IAM API.
publish_date: 2026-03-24T19:52:18.009725Z
last_updated: 2026-04-08T16:02:23.830724Z
---

Listing groups allows you to view all groups configured in your organization along with their members, descriptions, and status. This is useful for auditing group memberships, reviewing access configurations, and identifying groups available for role or policy assignments.

> [!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 all groups in your organization 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.

        The groups list displays all groups with their **Name**, **Description**, **Roles**, and **Members** count. Use the pagination controls at the bottom to switch pages or increase the per-page view if you have multiple groups.

=== "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}"
    ```

    The response contains the requested resources.