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

# Driver Behaviour Group Metrics

> POST request to return behaviour metrics for a group for the specified period.<br/><br/>The value specified for the endDate cannot be before startDate and the date range between startDate and endDate should be at least 7 days.



## OpenAPI

````yaml /api-reference/performance.json post /public/v1/customer/{customerId}/driverbehaviourmetrics/group
openapi: 3.0.1
info:
  title: Performance
  description: >-
    Delivers deeper insights into driver behaviour, fuel efficiency, CO₂ impact
    and safe driving practices.
  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: /alert
    description: Alert history and notification management operations
  - name: /driver
    description: Driver Operations
  - name: /driverbehaviourmetrics
    description: Driver Behaviour Metrics
  - name: customers
    description: Customer Behaviour Metrics
  - name: /ecoscore
    description: EcoScore
  - name: /fuel
    description: Fuel
  - name: /idling
    description: Idling
  - name: /speeding
    description: Speeding
  - name: /tokenInformation
    description: Token operations
  - name: /utilisation
    description: Utilisation
  - name: /vehicle
    description: Vehicle management operations
paths:
  /public/v1/customer/{customerId}/driverbehaviourmetrics/group:
    post:
      tags:
        - /driverbehaviourmetrics
        - customers
      summary: Driver Behaviour Group Metrics
      description: >-
        POST request to return behaviour metrics for a group for the specified
        period.<br/><br/>The value specified for the endDate cannot be before
        startDate and the date range between startDate and endDate should be at
        least 7 days.
      operationId: metricsForGroup
      parameters:
        - name: customerId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json;charset=UTF-8:
            schema:
              $ref: '#/components/schemas/GroupBehaviourMetricRequestDto'
      responses:
        '200':
          description: Successful operation
          content:
            application/json;charset=UTF-8:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/BehaviourMetricDto'
        '400':
          description: Bad input parameters
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/ApiErrorDto'
        '404':
          description: Resource not found
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/ApiErrorDto'
components:
  schemas:
    GroupBehaviourMetricRequestDto:
      required:
        - endDate
        - startDate
      type: object
      properties:
        startDate:
          type: string
          description: >-
            Start date and time for the behaviour metrics period. Format:
            yyyy-MM-dd'T'HH:mm:ss in UTC.
          format: date-time
        endDate:
          type: string
          description: >-
            End date and time for the behaviour metrics period. Format:
            yyyy-MM-dd'T'HH:mm:ss in UTC.
          format: date-time
        keys:
          type: array
          description: >-
            Array of keys for the KPI to return details for. Possible values:
            <ul><li>DrivingPercentage (Cleaner KPI)</li><li>SpeedCompliance
            (Safe Speed KPI)</li><li>HarshEventsPercentage (Smoother
            KPI)</li></ul>
          items:
            type: string
        timeZone:
          type: string
          description: Timezone identifier for the request (e.g., 'Europe/London', 'UTC')
        hierarchyNodeId:
          type: string
          description: >-
            Unique identifier of an existing group to retrieve behaviour metrics
            for
      description: >-
        Request parameters for group behaviour metrics including date range,
        metrics keys, and group identifier
    BehaviourMetricDto:
      type: object
      properties:
        key:
          type: string
          description: >-
            Metric key identifier (e.g., 'DrivingPercentage', 'SpeedCompliance',
            'HarshEventsPercentage')
        value:
          type: number
          description: Current metric value for the specified period
          format: double
        previousValue:
          type: number
          description: Previous metric value for comparison with the current period
          format: double
      description: >-
        Behaviour metric data containing key, current value, and previous value
        for comparison
    ApiErrorDto:
      type: object
      properties:
        errorCode:
          type: integer
          format: int32
        errorMessage:
          type: string
        offendingFields:
          type: array
          items:
            type: string
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````