---
title: "List of environment groups"
method: GET
path: "/environments/{envId}/groups"
tags: ["Groups"]
---

# List of environment groups

`GET /environments/{envId}/groups`

List of environment groups

List the groups of a given environment.

## Query parameters

- `page` integer
- `perPage` integer

## Response `200`

Page of Groups

- object
  - `data` Group[] — List of groups.
    - `id` string — Group's uuid.
    - `name` string — Group's name.
    - `eventRules` GroupEvent[] — Event rules for the group.
    - `manageable` boolean — Current user can manage group.
    - `createdAt` string, date-time — Group's creation date.
    - `updatedAt` string, date-time — Group's last updated date.
    - `maxInvitation` integer — Maximum number of group members.
    - `apiRole` string — The Api role of the group.
    - `lockApiRole` boolean — Api role cannot be changed.
    - `applicationRole` string — The Application role of the group.
    - `lockApplicationRole` boolean — Application role cannot be changed.
    - `lockApiProductRole` boolean — Api Product role cannot be changed.
    - `systemInvitation` boolean — Invitation via user search enabled.
    - `emailInvitation` boolean — Email invitation enabled.
    - `disableMembershipNotifications` boolean — Notifications of new members are disabled.
    - `primaryOwner` boolean — Group's members contain one primary owner.
    - `apiPrimaryOwner` string — The group member id with API primary owner role.
    - `apiProductPrimaryOwner` string — The group member id with API Product primary owner role.
  - `links` Links — List of links for pagination
    - `self` string — Link to current resource
    - `first` string — In a paginated response, link to the first page
    - `last` string — In a paginated response, link to the last page
    - `previous` string — In a paginated response, link to the previous page. Maybe null if current is the first page
    - `next` string — In a paginated response, link to the next page. Maybe null if current is the last page
  - `metadata` ResponseMetadata — Generic object to handle additional information about an entity. Can also be used for pagination data.
  - `pagination` Pagination — Generic object to handle pagination data.
    - `page` integer — The current page.
    - `perPage` integer — The number of items requested per page.
    - `pageCount` integer — The total number of pages.
    - `pageItemsCount` integer — The number of items for the current page.
    - `totalCount` integer — The total number of items, or `-1` if the count could not be computed within the configured timeout.

## Other responses

- `default` — Generic error response

---

[API](https://skmtc.net/gravitee-io/apis/gravitee-io-apim-management-api-apis.md) · [All operations](https://skmtc.net/gravitee-io/apis/gravitee-io-apim-management-api-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gravitee-io/gravitee-io-apim-management-api-apis/versions/aef12fc964d5/schema)