# List Groups

Your tenant's groups, by name, with how many members each has.

## Overview

- Every group of your tenant in one answer, in `data`, ordered by name whatever its case. The members are in [Get a Group](https://docs.aureahub.com/docs/group-get.md).
- For `owner`, `tenantadmin`, `non_signing_admin`, `auditor`, `security_admin` and `security_auditor`. What groups are for: [Policy Sets & Groups](https://docs.aureahub.com/docs/guide-policy-sets.md).

## Endpoint

### `GET /v1/groups`

Authentication: bearer token required.

Your tenant's groups with their member counts.

**Responses**

`200` OK

```json
{
  "data": [
    {
      "id": "3b8e1f6a-2c4d-4e9f-a1b7-6d5c4e3f2a10",
      "name": "Finance approvers",
      "description": "Approve transfers above 10,000 EUR",
      "memberCount": 3,
      "createdBy": "5d2c1b0a-9e8f-4a7b-8c6d-5e4f3a2b1c0d",
      "createdAt": "2026-10-08T09:12:40.118Z",
      "updatedAt": "2026-10-08T09:20:03.552Z"
    }
  ]
}
```

`403` Role

```json
{
  "statusCode": 403,
  "error": "ForbiddenError",
  "message": "Tenant admin access required. Your role does not have permission to perform this action."
}
```

**Example request**

```bash
curl https://api.aureahub.com/v1/groups \
  -H "Authorization: Bearer $ADMIN_TOKEN"
```

---

Web version: https://docs.aureahub.com/#groups-list