# Search user groups

Lists user groups within the organization, with optional filtering by parent or status.

Request:
includeDisabled    - When true, includes disabled groups in the results.
parentGroupId     - Optional parent group ID to return only direct child groups.

Response:
userGroups         - List of UserGroupItem objects matching the filter criteria.

Endpoint: POST /api/v1/user-group/list-user-groups
Version: 3.0
Security: bearerAuth

## Request fields (application/json):

  - `includeDisabled` (boolean)

  - `parentGroupId` (string)
    Rule data fields

## Response 200 fields (application/json):

  - `userGroups` (array)

  - `userGroups.id` (string)
    Rule data fields

  - `userGroups.parentGroupId` (string)
    Rule data fields

  - `userGroups.name` (string)
    Rule data fields

  - `userGroups.description` (string)
    Rule data fields

## Response 400 fields (application/json):

  - `message` (string)

## Response 401 fields (application/json):

  - `message` (string)

## Response 403 fields (application/json):

  - `message` (string)

## Response 404 fields (application/json):

  - `message` (string)

## Response 409 fields (application/json):

  - `message` (string)

## Response 429 fields (application/json):

  - `message` (string)

## Response 499 fields (application/json):

  - `message` (string)

## Response 500 fields (application/json):

  - `message` (string)

## Response 501 fields (application/json):

  - `message` (string)

## Response 503 fields (application/json):

  - `message` (string)

## Response 504 fields (application/json):

  - `message` (string)