---
title: "List groups"
method: GET
path: "/groups"
tags: ["Groups"]
---

# List groups

`GET /groups`

Lists all available groups.

## Query parameters

- `name` string
- `mapping` string
- `createdOn` string, date
- `lastModifiedOn` string, date
- `sortField` string — Sort field options available for groups. Possible values are: `NAME`, `CREATED_ON` or `LAST_MODIFIED_ON`.
- `sortOrder` string — Order on the sort field options available for groups. Possible values are: `ASC` or `DESC`.
- `limit` integer
- `after` string, nullable

## Response `200`

The list of groups.

- PagedGroups — A page of groups.
  - `cursors` Cursors, required — A cursor refers to a random string of characters which marks a specific item in a list of data. The cursor will always point to the item, however it will be invalidated if the item is deleted or removed. Therefore, your app shouldn't store cursors or assume that they will be valid in the future.
    - `after` string — This is the cursor that points to the end of the page of data that has been returned.
  - `results` Group[], required
    - `name` string, required — The name of the group.
    - `mappings` GroupMapping[], required
      - `provider` string, required — Value must be "Snowflake", "GoogleBigQuery, or "AWSLakeFormation"
      - `identity` string, required — An existing Snowflake, GoogleBigQuery or AWSLakeFormation role.

## Other responses

- `400` — The request is not valid.
- `401` — The client is not authenticated.
- `403` — The user lacks permissions.
- `500` — There was an error processing the request.

---

[API](https://skmtc.net/collibra/apis/collibra-data-governance-center-core-api.md) · [All operations](https://skmtc.net/collibra/apis/collibra-data-governance-center-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/collibra/collibra-data-governance-center-core-api/revisions/6d091bc86a33/schema)