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

# List employee groups

> Returns the employee groups belonging to the given organization. This endpoint is not paginated and does not support client-controlled sorting — every group belonging to the organization is returned in a single response, always sorted by name in ascending order. Returns 403 when the authenticated user is not an administrator of the organization.




## OpenAPI

````yaml /openapi/findity-admin-api.json get /organizations/{organizationId}/employeegroups
openapi: 3.1.0
info:
  title: Findity Admin API
  description: Findity Admin API
  version: 1.0.0
servers:
  - url: https://stage-api.findity.com/api/v1/admin
  - url: https://api.findity.com/api/v1/admin
security:
  - bearerAuth: []
paths:
  /organizations/{organizationId}/employeegroups:
    get:
      tags:
        - Employee Groups
      summary: List employee groups
      description: >
        Returns the employee groups belonging to the given organization. This
        endpoint is not paginated and does not support client-controlled sorting
        — every group belonging to the organization is returned in a single
        response, always sorted by name in ascending order. Returns 403 when the
        authenticated user is not an administrator of the organization.
      operationId: adminListEmployeeGroups
      parameters:
        - name: organizationId
          in: path
          required: true
          description: |
            String. The organization's internal ID (32-character hex string).
          schema:
            type: string
            example: 11adfe2a080040e3892ffb89c21ec44e
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArrayOfAdminApiEmployeeGroups'
              example:
                meta:
                  count: 2
                  total: 2
                data:
                  - id: 3f2a9c1b8e7d4a6f9b0c1d2e3f4a5b6c
                    name: Sales Team
                    isDefault: false
                  - id: 7b1e4d2a9c8f3e6b5a0d1c2f4e6a8b0d
                    name: Head Office
                    isDefault: true
        '403':
          description: >-
            Forbidden — the authenticated user is not an administrator of the
            organization
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/403Error'
              examples:
                Permission denied:
                  value:
                    result: error
                    description: Permission denied
components:
  schemas:
    ArrayOfAdminApiEmployeeGroups:
      type: object
      properties:
        meta:
          type: object
          properties:
            count:
              type: integer
              description: >-
                Number of employee groups returned. Always equal to `total` —
                this endpoint is not paginated.
            total:
              type: integer
              description: Total number of employee groups belonging to the organization.
          required:
            - count
            - total
        data:
          type: array
          items:
            $ref: '#/components/schemas/AdminApiEmployeeGroup'
      required:
        - meta
        - data
    403Error:
      type: object
      properties:
        result:
          type: string
        description:
          type: string
      example:
        result: error
        description: Not allowed
    AdminApiEmployeeGroup:
      type: object
      required:
        - id
        - name
        - isDefault
      properties:
        id:
          type: string
          description: Unique internal identifier of the employee group.
        name:
          type: string
          description: Display name of the employee group.
        isDefault:
          type: boolean
          description: >
            Whether this is the organization's default employee group. When the
            organization uses employee groups, users newly added to the
            organization are automatically assigned to the default group, when
            one is set. Existing users are not moved to the group when it is set
            as default. At most one group per organization can be the default at
            a time.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````