---
title: "Retrieve UserGroup by ID"
method: GET
path: "/v3/security/userGroups/{uniqueId}"
tags: ["User Groups"]
---

# Retrieve UserGroup by ID

`GET /v3/security/userGroups/{uniqueId}`

Returns a single UserGroup corresponding to provided uniqueId

## Path parameters

- `uniqueId` '1' | '2' | '3', required — param ID of the UserGroup that needs to be fetched

## Query parameters

- `fields` string[]
- `count` string

## Response `200`

The UserGroup

- UserGroup
  - `id` integer
  - `name` string
  - `description` string
  - `users` ListEntityUser
    - `data` User[]
      - `id` integer
      - `userName` string
      - `firstName` string
      - `lastName` string
      - `pseudonym` string
      - `owner` string
      - `password` string
      - `lastLogin` string, date-time
      - `lastPasswordChange` string, date-time
      - `uiTheme` string
      - `jobFunction` string
      - `jobRole` string
      - `termsAccepted` boolean
      - `termsAcceptedDate` string, date-time
      - `logoutIntervalMinutes` integer
      - `tqlTimeout` integer
      - `systemRole` string
      - `ownerRoles` object
      - `disabled` boolean
      - `locked` boolean
      - `passwordResetRequired` boolean
      - `twoFactorResetRequired` boolean
      - `customTqlTimeout` integer
    - `count` integer
    - `countSuccess` integer
    - `countFailure` integer
    - `count_type` string
    - `next` string
    - `prev` string
    - `mode` string

---

[API](https://skmtc.net/threatconnect/apis/threatconnect-api.md) · [All operations](https://skmtc.net/threatconnect/apis/threatconnect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/threatconnect/threatconnect-api/versions/730b8a350ae7/schema)