---
title: "List All User Groups"
url: "https://public-api-docs.cipherscale.com/apis/cipherscale-api-1/versions/fef69080-6094-4620-8bf0-16fd2de7b598/operations/GroupsController_findAll"
---

> Full API specification: https://public-api-docs.cipherscale.com/apis/cipherscale-api-1/versions/fef69080-6094-4620-8bf0-16fd2de7b598.md

# List All User Groups

`GET` `/tenants/groups`

Operation ID: `GroupsController_findAll`

Retrieves a paginated list of all user groups in the tenant, including their role assignments, member counts, and configuration settings.

## Query parameters

- `sort` (array, optional)
- `limit` (number, optional)
- `offset` (number, optional)

## Responses

- `200` - Successfully retrieved groups
- `401` - Unauthorized - Invalid or missing authentication token
- `403` - Forbidden - Insufficient permissions. Requires OWNER, ADMIN, AUDITOR, or SUPPORT role.

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Cipherscale API
  version: "1.0"
servers:
  - url: https://public-api.cipherscale.com/qa
    description: Cipherscale Public API Server
paths:
  /tenants/groups:
    get:
      operationId: GroupsController_findAll
      summary: List All User Groups
      description: Retrieves a paginated list of all user groups in the tenant,
        including their role assignments, member counts, and configuration
        settings.
      parameters:
        - name: sort
          required: false
          in: query
          schema:
            type: array
            items:
              type: string
        - required: false
          name: limit
          in: query
          schema:
            type: number
        - required: false
          name: offset
          in: query
          schema:
            type: number
      responses:
        "200":
          description: Successfully retrieved groups
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaginatedDto"
        "401":
          description: Unauthorized - Invalid or missing authentication token
        "403":
          description: Forbidden - Insufficient permissions. Requires OWNER, ADMIN,
            AUDITOR, or SUPPORT role.
      tags:
        - Groups
      security:
        - ApiKeyAuth: []
security:
  - ApiKeyAuth: []
components:
  schemas:
    PaginatedDto:
      type: object
      properties: {}
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: apikey
```