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

> POST request to return the behaviour metrics for each day in the period for a driver. As well as a value for the behaviour metric for each day, the response also includes a value for the behaviour metric for the whole of 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
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:
    post:
      tags:
        - /driverbehaviourmetrics
        - customers
      summary: Driver Behaviour Metrics
      description: >-
        POST request to return the behaviour metrics for each day in the period
        for a driver. As well as a value for the behaviour metric for each day,
        the response also includes a value for the behaviour metric for the
        whole of 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: metricsForPerson
      parameters:
        - name: customerId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json;charset=UTF-8:
            schema:
              $ref: '#/components/schemas/DriverBehaviourMetricRequestDto'
      responses:
        '200':
          description: Successful operation
          content:
            application/json;charset=UTF-8:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/BehaviourMetricDailyDto'
        '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:
    DriverBehaviourMetricRequestDto:
      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')
        driverId:
          type: string
          description: Identifier of a driver
      description: >-
        Request parameters for driver behaviour metrics including date range,
        metrics keys, and driver identifier
    BehaviourMetricDailyDto:
      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
        startDate:
          type: string
          description: Start date and time for the daily metric period
          format: date-time
        endDate:
          type: string
          description: End date and time for the daily metric period
          format: date-time
      description: Behaviour metric data with daily date range for aggregated metrics
    ApiErrorDto:
      type: object
      properties:
        errorCode:
          type: integer
          format: int32
        errorMessage:
          type: string
        offendingFields:
          type: array
          items:
            type: string
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````