# Get a Group

One group and its members.

## Overview

- The group as [List Groups](https://docs.aureahub.com/docs/groups-list.md) answers it, with `members`, ordered by username: `userId`, `username`, `role`, who added them (`addedBy`) and when (`addedAt`).
- `404` `GROUP_NOT_FOUND` (`No such group in the tenant`) for a group that is not your tenant's. Same roles as List Groups.

## Endpoint

### `GET /v1/groups/{groupId}`

Authentication: bearer token required.

One group with its members.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `groupId` | string (uuid) | yes | The group's id |

**Responses**

`200` OK

```json
{
  "id": "3b8e1f6a-2c4d-4e9f-a1b7-6d5c4e3f2a10",
  "name": "Finance approvers",
  "description": "Approve transfers above 10,000 EUR",
  "memberCount": 2,
  "createdBy": "5d2c1b0a-9e8f-4a7b-8c6d-5e4f3a2b1c0d",
  "createdAt": "2026-10-08T09:12:40.118Z",
  "updatedAt": "2026-10-08T09:20:03.552Z",
  "members": [
    {
      "userId": "0d2f6b8a-4c1e-4a93-b7d5-2e9f1c3a8b60",
      "username": "giulia.finance",
      "role": "approver",
      "addedBy": "5d2c1b0a-9e8f-4a7b-8c6d-5e4f3a2b1c0d",
      "addedAt": "2026-10-08T09:15:11.402Z"
    },
    {
      "userId": "6a1c9e3f-2b7d-4f50-8e4a-0c5d3b9f7e12",
      "username": "marco.cfo",
      "role": "tenantadmin",
      "addedBy": "5d2c1b0a-9e8f-4a7b-8c6d-5e4f3a2b1c0d",
      "addedAt": "2026-10-08T09:20:03.552Z"
    }
  ]
}
```

`404` Not found

```json
{
  "statusCode": 404,
  "error": "NotFoundError",
  "message": "No such group in the tenant",
  "details": { "code": "GROUP_NOT_FOUND" }
}
```

---

Web version: https://docs.aureahub.com/#group-get