---
title: "Retrieves user group by its ID."
method: GET
path: "/gdc/userGroups/{groupId}"
tags: ["user-groups"]
---

# Retrieves user group by its ID.

`GET /gdc/userGroups/{groupId}`

## Request

- Base URL: `https://secure.gooddata.com`
- URL: `https://secure.gooddata.com/gdc/userGroups/{groupId}`
- Auth: none declared

## Path parameters

- `groupId` string, required

## Response `200`

The user group specified by given id is successfully returned.

- UserGroup
  - `userGroup` object, required
    - `content` UserGroupContent, required
      - `name` string, required
      - `id` string, nullable: Id of the user group is ignored in POST, as it is not known.
      - `description` string, nullable
      - `domain` union: Deprecated, value ignored. It is here because of backward compatibility.
        - string, uri: URI of the domain
        - string, uri, nullable: Domain uri in a deprecated format because of backward compatibility.
      - `project` string, uri, nullable: Can not be changed in PUT. Has to be specified.
    - `meta` UserGroupMeta: User group metainformation is ignored in write operations.
      - `created` string: Date and time string in the format `YYYY-MM-DD hh:mm:ss`
      - `updated` string: Date and time string in the format `YYYY-MM-DD hh:mm:ss`
    - `links` UserGroupLinks
      - `self` string, required: URI of the user group
      - `members` string, uri, required
      - `modifyMembers` string, uri, required

## Other responses

- `403`: The API call failed because you do not have persmission to display informations about user groups and their members ("UserGroupReadPermission").
- `404`: The API call failed because the user group you requested does not exist.
- `default`: Common error

---

[API](https://skmtc.dev/gooddata/apis/gooddata-api-documentation.md) - [All operations](https://skmtc.dev/gooddata/apis/gooddata-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/gooddata/apis/gooddata-api-documentation/revisions/e5dc0ee6ab00?raw)