> ## Documentation Index
> Fetch the complete documentation index at: https://docs.claap.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List user groups

> List the user groups of the workspace with their members.

Lists the user groups of the workspace, called teams in the app, with the identifiers of their members. Member identifiers are the user `id` returned by the [list users](/api-reference/endpoint/list_users) endpoint.


## OpenAPI

````yaml GET /v1/user-groups
openapi: 3.1.0
info:
  title: Claap API
  description: Development documentation
  version: 0.0.0
servers:
  - url: https://api.claap.io/
security:
  - ApiKey: []
paths:
  /v1/user-groups:
    get:
      description: List the user groups of the workspace with their members.
      operationId: getV1UserGroups
      parameters:
        - in: query
          name: cursor
          schema:
            type: string
            description: >-
              Paginate the results starting at the cursor returned by a previous
              call. Pages may contain fewer than "limit" results; iterate until
              no nextCursor is returned.
        - in: query
          name: limit
          schema:
            type: number
            minimum: 1
            maximum: 100
            default: 20
            description: Return at most "limit" results.
      responses:
        '200':
          description: User groups were successfully retrieved
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    type: object
                    properties:
                      userGroups:
                        type: array
                        items:
                          $ref: '#/components/schemas/ApiUserGroup'
                      pagination:
                        type: object
                        properties:
                          nextCursor:
                            type: string
                    required:
                      - userGroups
                      - pagination
                required:
                  - result
        '400':
          description: Cursor is not valid.
components:
  schemas:
    ApiUserGroup:
      type: object
      properties:
        userGroupId:
          type: string
          description: User group identifier.
        name:
          type: string
          description: User group name.
        memberUserIds:
          type: array
          items:
            type: string
          description: Identifiers of the workspace users in the group.
      required:
        - userGroupId
        - name
        - memberUserIds
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: X-Claap-Key

````