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

# List Group

> Returns the group hierarchy starting from the root node.



## OpenAPI

````yaml /api-reference/fleet-management.json get /public/v1/customer/{customerId}/group
openapi: 3.0.1
info:
  title: Fleet management
  description: >-
    A comprehensive administration pack enabling full control over fleet
    structures, users, drivers, vehicles and operational data.
  contact:
    name: Masternaut
    url: https://www.masternaut.com
    email: support@masternautconnect.com
  version: 124.0.2607160821
servers:
  - url: https://api.masternautconnect.com/connect-webservices/services
    description: Product Server
security:
  - basicAuth: []
tags:
  - name: /driver
    description: Driver Operations
  - name: /group
    description: Group operations
  - name: /location/category
    description: Location category management operations
  - name: /location
    description: Location management operations
  - name: /role
    description: Role operations
  - name: /tokenInformation
    description: Token operations
  - name: /user
    description: User operations
  - name: /maintenance
    description: Vehicle maintenance operations
  - name: /vehicle
    description: Vehicle management operations
paths:
  /public/v1/customer/{customerId}/group:
    get:
      tags:
        - /group
      summary: List Group
      description: Returns the group hierarchy starting from the root node.
      operationId: getAllGroups
      parameters:
        - name: customerId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: >-
            List of Groups visible to request context with counts of drivers and
            vehicles
          content:
            application/json;charset=UTF-8:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/GroupSearchResultDto'
components:
  schemas:
    GroupSearchResultDto:
      required:
        - id
      type: object
      properties:
        id:
          maxLength: 24
          minLength: 1
          pattern: ^[a-z0-9]+$
          type: string
          description: ID of group
          example: groupID
        name:
          maxLength: 255
          minLength: 0
          type: string
          description: Group name
          example: group-name
        parentId:
          type: string
          description: ID of parent group, in case for changing the hierarchy
          example: rootGroupId
        path:
          type: string
          description: Hierarchy path from root group
          readOnly: true
          example: rootGroupId.groupID
        countDrivers:
          type: integer
          description: Count of assigned drivers to group
          format: int32
          readOnly: true
          example: 1
        countSecondaryDrivers:
          type: integer
          description: Count of assigned secondary drivers to group
          format: int32
          readOnly: true
          example: 1
        countSecondaryVehicles:
          type: integer
          description: Count of assigned secondary vehicles to group
          format: int32
          readOnly: true
          example: 0
        dataCleanupSettings:
          $ref: '#/components/schemas/DataCleanupSettingsDto'
        countVehicles:
          type: integer
          description: Count of assigned vehicles to group
          format: int32
          readOnly: true
          example: 0
    DataCleanupSettingsDto:
      type: object
      properties:
        truncate:
          type: boolean
          description: >-
            Indicates whether data for this group should be truncated upon
            reaching the retention threshold. A value of true enables
            truncation; false disables it. A null value means this setting is
            unspecified at this group level and is inherited from the nearest
            ancestor in the hierarchy, or from the customer data retention
            settings if no ancestor defines a value.
        daysRetention:
          type: integer
          description: >-
            The number of days that standard data is retained for this group
            before becoming eligible for cleanup. A null value means this
            setting is unspecified at this group level and is inherited from the
            nearest ancestor in the hierarchy, or from the customer data
            retention settings if no ancestor defines a value.<br/>Note: a value
            of 0 is functionally distinct from null and would mean data is
            deleted immediately; null must NOT be substituted with 0.
          format: int32
        daysRetentionLong:
          type: integer
          description: >-
            The number of days that long-term data is retained for this group
            before becoming eligible for cleanup. A null value means this
            setting is unspecified at this group level and is inherited from the
            nearest ancestor in the hierarchy, or from the customer data
            retention settings if no ancestor defines a value.<br/>Note: a value
            of 0 is functionally distinct from null and would mean long-term
            data is deleted immediately; null must NOT be substituted with 0.
          format: int32
      description: >-
        Data retention and cleanup configuration inherited or explicitly set for
        this group. A null value for any field indicates that the setting is
        unspecified at this level and will be inherited from the nearest
        ancestor group in the hierarchy that has a value defined, or from the
        customer-level data retention settings if no ancestor group specifies
        one. Fields must NOT be defaulted to 0 or false when unset, as those
        values carry distinct functional meaning.
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````