> ## 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.

# Get employee group

> Returns a single employee group by its ID. Returns 403 when the authenticated user is not an administrator of the organization. Returns 404 when the employee group does not exist, or belongs to a different organization.




## OpenAPI

````yaml /openapi/findity-admin-api.json get /organizations/{organizationId}/employeegroups/{employeeGroupId}
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/{employeeGroupId}:
    get:
      tags:
        - Employee Groups
      summary: Get employee group
      description: >
        Returns a single employee group by its ID. Returns 403 when the
        authenticated user is not an administrator of the organization. Returns
        404 when the employee group does not exist, or belongs to a different
        organization.
      operationId: adminGetEmployeeGroup
      parameters:
        - name: organizationId
          in: path
          required: true
          description: |
            String. The organization's internal ID (32-character hex string).
          schema:
            type: string
            example: 11adfe2a080040e3892ffb89c21ec44e
        - name: employeeGroupId
          in: path
          required: true
          description: >
            String (32-character hex string). The internal ID of the employee
            group to retrieve, as returned in the `id` field of the list,
            create, and update responses.
          schema:
            type: string
            example: 3f2a9c1b8e7d4a6f9b0c1d2e3f4a5b6c
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdminApiEmployeeGroup'
              example:
                id: 3f2a9c1b8e7d4a6f9b0c1d2e3f4a5b6c
                name: Sales Team
                isDefault: false
        '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
        '404':
          description: >-
            Not found — employee group does not exist, or belongs to a different
            organization
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/404Error'
              examples:
                Employee group not found:
                  value:
                    result: error
                    code: EMPLOYEE_GROUP_NOT_FOUND
                    description: Employee group not found
components:
  schemas:
    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.
    403Error:
      type: object
      properties:
        result:
          type: string
        description:
          type: string
      example:
        result: error
        description: Not allowed
    404Error:
      type: object
      properties:
        result:
          type: string
        code:
          type: string
        description:
          type: string
      example:
        result: error
        code: ORGANIZATION_NOT_FOUND
        description: 'Failed to get organization for id: {orgId}'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````