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

# Vehicle Journeys

> Returns summary journey details for a vehicle for each journey that started in the specified period. For a private journey only limited details are returned. The end date of the journey does not have to be within the specified period. The value specified for the endDate cannot be before startDate.<br/><br/>Either vehicleId or groupId must be specified. If vehicleId is specified, then only journeys for the specified vehicle are included in the output. If groupId is specified, then the details for all vehicles in the specified group are included in the output. Either vehicleId or groupId can be specified as an input parameter, an error is returned if both are specified.<br/><br/>If there are more than 50 journeys that match the search criteria, then by default only the first 50 journeys are returned. To view details of the other journeys you will need to specify values for pageSize and pageIndex.<br/><br/><b>Asset Day Limit:</b><br/>The asset day limit on this endpoint is 1000 asset days. You will receive an HTTP status code of 400 (Bad input parameters) and no details will be returned if you exceed this restriction.



## OpenAPI

````yaml /api-reference/vehicle-tracking.json get /public/v1/customer/{customerId}/journey/detail/vehicle
openapi: 3.0.1
info:
  title: Vehicle Tracking
  description: >-
    A foundational pack delivering essential “track & trace” capability across
    your fleet.
  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: /input
    description: Input usage operations for vehicles and drivers
  - name: /journey/detail
    description: Journey detail operations with vehicle and driver perspectives
  - name: /location
    description: Location management operations
  - name: /tokenInformation
    description: Token operations
  - name: /tracking/history
    description: Tracking history operations for vehicles and drivers
  - name: /tracking/journey
    description: Journey tracking and management operations
  - name: /tracking/live
    description: Live tracking operations
  - name: /vehicle
    description: Vehicle management operations
paths:
  /public/v1/customer/{customerId}/journey/detail/vehicle:
    get:
      tags:
        - /journey/detail
      summary: Vehicle Journeys
      description: >-
        Returns summary journey details for a vehicle for each journey that
        started in the specified period. For a private journey only limited
        details are returned. The end date of the journey does not have to be
        within the specified period. The value specified for the endDate cannot
        be before startDate.<br/><br/>Either vehicleId or groupId must be
        specified. If vehicleId is specified, then only journeys for the
        specified vehicle are included in the output. If groupId is specified,
        then the details for all vehicles in the specified group are included in
        the output. Either vehicleId or groupId can be specified as an input
        parameter, an error is returned if both are specified.<br/><br/>If there
        are more than 50 journeys that match the search criteria, then by
        default only the first 50 journeys are returned. To view details of the
        other journeys you will need to specify values for pageSize and
        pageIndex.<br/><br/><b>Asset Day Limit:</b><br/>The asset day limit on
        this endpoint is 1000 asset days. You will receive an HTTP status code
        of 400 (Bad input parameters) and no details will be returned if you
        exceed this restriction.
      operationId: getJourneyDetailVehicle
      parameters:
        - name: customerId
          in: path
          required: true
          schema:
            type: string
        - name: startDate
          in: query
          description: >-
            Start date of time interval used for filtering. Mandatory and cannot
            be later then 'endDate'.
          required: true
          schema:
            type: string
            description: >-
              Start date of time interval used for filtering. Mandatory and
              cannot be later then 'endDate'.
            format: date-time
        - name: endDate
          in: query
          description: >-
            End date of time interval used for filtering. Mandatory and cannot
            be sooner then 'startDate'.
          required: true
          schema:
            type: string
            description: >-
              End date of time interval used for filtering. Mandatory and cannot
              be sooner then 'startDate'.
            format: date-time
        - name: groupId
          in: query
          description: >-
            Id of Group used for filtering. @Visible validation, mandatory if
            'id' is not provided, but cannot be both filled
          required: false
          schema:
            type: string
            description: >-
              Id of Group used for filtering. @Visible validation, mandatory if
              'id' is not provided, but cannot be both filled
        - name: pageIndex
          in: query
          description: Number of page, default = 0.
          required: false
          schema:
            type: integer
            description: Number of page, default = 0.
            format: int32
        - name: pageSize
          in: query
          description: Batches per page, default = 50.
          required: false
          schema:
            type: integer
            description: Batches per page, default = 50.
            format: int32
        - name: excludeChildGroups
          in: query
          description: Exclude child groups, default = FALSE.
          required: false
          schema:
            type: boolean
            description: Exclude child groups, default = FALSE.
        - name: vehicleId
          in: query
          description: >-
            Id of vehicle used for filtering. @Visible validation, mandatory if
            'groupId' is not provided, but cannot be both filled
          required: false
          schema:
            type: string
            description: >-
              Id of vehicle used for filtering. @Visible validation, mandatory
              if 'groupId' is not provided, but cannot be both filled
      responses:
        '200':
          description: >-
            List for Journeys Details (TimestampedWithPaginationResult) selected
            by VehicleId or GroupId, and from given Execution time. May be empty
            list if now Journeys has been found.
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: >-
                  #/components/schemas/TimestampedWithPaginationResultJourneyDetailVehicleDto
        '400':
          description: >-
            Bad input parameters - when endDate is before startDate, both
            vehicleId and groupId are specified, or asset day limit exceeded
        '404':
          description: No journeys found for the specified criteria
components:
  schemas:
    TimestampedWithPaginationResultJourneyDetailVehicleDto:
      type: object
      properties:
        totalPages:
          type: integer
          description: Total number of pages based on the pageSize.
          format: int32
        totalCount:
          type: integer
          description: Total number of items that matched the search parameters.
          format: int64
        items:
          type: array
          description: Array of items.
          items:
            $ref: '#/components/schemas/JourneyDetailVehicleDto'
        processedDateTime:
          type: string
          description: >-
            Date and time when the request was completed, in UTC, in format of
            YYYY-MM-DDThh:mm:ss.ms.
          format: date-time
      description: >-
        Generic wrapper for paginated API responses containing items, pagination
        metadata, and processing timestamp.
    JourneyDetailVehicleDto:
      type: object
      properties:
        vehicleRegistration:
          type: string
          description: The registration of the vehicle.
        vehicleName:
          type: string
          description: The friendly name of the vehicle.
        driverName:
          type: string
          description: >-
            Name of the driver which is either the default driver for the
            vehicle or the driver that signed in with a driver key.
        totalTimeIdledSeconds:
          type: integer
          description: Total time in seconds that the vehicle was idling.
          format: int64
        totalTimeDrivenSeconds:
          type: integer
          description: Total time in seconds that the vehicle was driving.
          format: int64
        totalTimeDrivenWithPtoSeconds:
          type: integer
          description: >-
            Total time in seconds that the vehicle was driving and where the PTO
            input was active.
          format: int64
        totalTimeDrivenWithoutPtoSeconds:
          type: integer
          description: >-
            Total time in seconds that the vehicle was driving and where the PTO
            input was inactive.
          format: int64
        totalTimeIdledWithPtoSeconds:
          type: integer
          description: >-
            Total time in seconds that the vehicle was idling and the PTO was
            active.
          format: int64
        totalTimeStoppedSeconds:
          type: integer
          description: >-
            Total time in seconds that the vehicle was stopped, i.e. total time
            from the end of this journey to the start of the next journey. Will
            be zero if this is the last journey that matched the search
            parameters.
          format: int64
        startDate:
          type: string
          description: >-
            Start date and time of the journey, in UTC, in format of
            YYYY-MM-DDThh:mm:ss
          format: date-time
        endDate:
          type: string
          description: >-
            End date and time of the journey, in UTC, in format of
            YYYY-MM-DDThh:mm:ss
          format: date-time
        startAddress:
          type: string
          description: >-
            Formatted address for the start point of the journey. Not included
            for a private journey.
        endAddress:
          type: string
          description: >-
            Formatted address for the end point of the journey. Not included for
            a private journey.
        distanceKm:
          type: number
          description: Journey distance in KM.
          format: double
        maximumSpeedKph:
          type: number
          description: >-
            Maximum speed (in KpH) during the journey. Not included for a
            private journey.
          format: double
        averageSpeedKph:
          type: number
          description: >-
            Average speed (in KpH) during the journey. Not included for a
            private journey.
          format: double
        startCoordinate:
          $ref: '#/components/schemas/Coordinate'
        endCoordinate:
          $ref: '#/components/schemas/Coordinate'
        startOdometer:
          type: number
          description: The odometer reading at the start of the journey.
          format: double
        endOdometer:
          type: number
          description: The odometer reading at the end of the journey.
          format: double
        startLocationName:
          type: string
          description: >-
            The POI location name if the journey started within the geo-fence
            boundary of a POI location. Not included for a private journey.
        endLocationName:
          type: string
          description: >-
            The POI location name if the journey ended within the geo-fence
            boundary of a POI location. Not included for a private journey.
        startLocationId:
          type: string
          description: >-
            Unique, unchangeable system generated identifier for the start POI
            location.
        endLocationId:
          type: string
          description: >-
            Unique, unchangeable system generated identifier (alphanumeric) for
            the end POI location.
        idlingFidelity:
          type: integer
          description: >-
            The type of idling that can be detected on the vehicle. Values are:
            <ol><li>0 = Idling is not supported</li><li>1 = Idling is detected
            when the vehicle is stationary</li><li>2 = Idling is detected when
            the vehicle is stationary and the engine is running.</li></ol>
          format: int32
        startElectricRangeKm:
          type: number
          description: >-
            The range (in km) for the electric vehicle at the start of the
            journey.
          format: float
        startElectricRangeKmEstimated:
          type: boolean
          description: >-
            Boolean (true/false) if the range was estimated - true if estimated,
            false if received from the vehicle.
        endElectricRangeKm:
          type: number
          description: >-
            The range (in km) for the electric vehicle at the end of the
            journey.
          format: float
        endElectricRangeKmEstimated:
          type: boolean
          description: >-
            Boolean (true/false) if the range was estimated - true if estimated,
            false if received from the vehicle.
        startElectricBatteryLevelPercent:
          type: number
          description: >-
            The electric vehicle battery level as a percentage at the start of
            the journey.
          format: float
        startElectricBatteryLevelPercentEstimated:
          type: boolean
          description: >-
            Boolean (true/false) if the electric vehicle battery level was
            estimated - true if estimated, false if received from the vehicle.
        endElectricBatteryLevelPercent:
          type: number
          description: >-
            The electric vehicle battery level as a percentage at the end of the
            journey.
          format: float
        endElectricBatteryLevelPercentEstimated:
          type: boolean
          description: >-
            Boolean (true/false) if the electric vehicle battery level was
            estimated - true if estimated, false if received from the vehicle.
        startFuelLevelPercentage:
          type: number
          description: >-
            The fuel level as a percentage at the start of the journey. If fuel
            level is received then either startFuelLevelPercentage or
            startFuelLevelLitres will be returned.
          format: float
        endFuelLevelPercentage:
          type: number
          description: >-
            The fuel level as a percentage at the end of the journey. If fuel
            level is received then either endFuelLevelPercentage or
            endFuelLevelLitres will be returned.
          format: float
        startFuelLevelLitres:
          type: number
          description: >-
            The fuel level in litres at the start of the journey. If fuel level
            is received then either startFuelLevelPercentage or
            startFuelLevelLitres will be returned.
          format: float
        endFuelLevelLitres:
          type: number
          description: >-
            The fuel level in litres at the end of the journey. If fuel level is
            received then either endFuelLevelPercentage or endFuelLevelLitres
            will be returned.
          format: float
        startEngineHours:
          type: number
          description: Engine Hours at the start of the journey.
          format: float
        endEngineHours:
          type: number
          description: Engine Hours at the end of the journey.
          format: float
        fuelUsedPetrolEquivalentLitres:
          type: number
          description: >-
            The total energy (Electricity, Gas,Petrol, Diesel) used for this
            journey is expressed as the petrol equivalent in litres.
          format: double
        co2Kg:
          type: number
          description: CO2 (in kg) for the total fuel/gas used for this journey.
          format: double
        fuelUsedLitres:
          type: number
          description: Petrol or Diesel fuel used in this journey, in litres.
          format: double
        electricUsedkWh:
          type: number
          description: Electricity used for this journey in kWh.
          format: float
        electricUsedkWhEstimated:
          type: boolean
          description: >-
            Boolean (true/false) if the electricity used was estimated - true if
            estimated, false if received from the vehicle.
        gasUsedKg:
          type: number
          description: Gas for this journey in Kg.
          format: float
        vehicleId:
          type: string
          description: >-
            Unique, unchangeable system generated identifier (alphanumeric) for
            the vehicle.
        vehicleGroupName:
          type: string
          description: Name of the group the vehicle has been assigned to.
        driverId:
          type: string
          description: >-
            Unique, unchangeable system generated identifier (alphanumeric) for
            the driver.
        commonAttributesFromJourneyTimeSheetDetail:
          $ref: '#/components/schemas/JourneyTimeSheetDetail'
        commonAttributesFromAsset:
          $ref: '#/components/schemas/Asset'
      description: >-
        Detailed journey information for a vehicle including timing, location,
        distance, speed, fuel consumption, and CO2 emissions data. For private
        journeys, only limited details are returned (vehicle identification,
        timing, and distance). Contains comprehensive vehicle-specific journey
        metrics and environmental impact data.
    Coordinate:
      type: object
      properties:
        longitude:
          type: number
          description: Longitude coordinate in decimal degrees.
          format: double
          example: -1.3421
        latitude:
          type: number
          description: Latitude coordinate in decimal degrees.
          format: double
          example: 53.8304
      description: >-
        Geographic coordinate with latitude and longitude values in decimal
        degrees.
    JourneyTimeSheetDetail:
      type: object
      properties:
        personId:
          type: string
        assetId:
          type: string
        classification:
          type: string
        startCoordinate:
          $ref: '#/components/schemas/Coordinate'
        endCoordinate:
          $ref: '#/components/schemas/Coordinate'
        entityGroupName:
          type: string
        assetRegistration:
          type: string
        personName:
          type: string
        startOdometer:
          type: number
          format: double
        endOdometer:
          type: number
          format: double
        startAddress:
          type: string
        endAddress:
          type: string
        distanceKm:
          type: number
          format: double
        journeyCount:
          type: integer
          format: int32
        ptoEnabled:
          type: boolean
        idlingFidelity:
          type: integer
          format: int32
        startFuelLevelLitres:
          type: number
          format: float
        endFuelLevelLitres:
          type: number
          format: float
        evConsumptionKwh:
          type: number
          format: float
        gasConsumptionKg:
          type: number
          format: float
        evConsumptionKwhEstimated:
          type: boolean
        linkedAssetName:
          type: string
        speedSensitive:
          type: boolean
        totalTimeIdledSeconds:
          type: integer
          format: int64
        totalTimeDrivenSeconds:
          type: integer
          format: int64
        maximumSpeedKph:
          type: number
          format: double
        averageSpeedKph:
          type: number
          format: double
        totalTimeDrivenWithPtoSeconds:
          type: integer
          format: int64
        totalTimeDrivenWithoutPtoSeconds:
          type: integer
          format: int64
        totalTimeIdledWithPtoSeconds:
          type: integer
          format: int64
        totalTimeStoppedSeconds:
          type: integer
          format: int64
        totalFuel:
          type: number
          format: double
        stoppedTimeSeconds:
          type: integer
          format: int64
          writeOnly: true
        requestNodeName:
          type: string
        startLocationName:
          type: string
        endLocationName:
          type: string
        startLocationId:
          type: string
        endLocationId:
          type: string
        startElectricRangeKm:
          type: number
          format: float
        startElectricRangeKmEstimated:
          type: boolean
        endElectricRangeKm:
          type: number
          format: float
        endElectricRangeKmEstimated:
          type: boolean
        startElectricBatteryLevelPercent:
          type: number
          format: float
        startElectricBatteryLevelPercentEstimated:
          type: boolean
        endElectricBatteryLevelPercent:
          type: number
          format: float
        endElectricBatteryLevelPercentEstimated:
          type: boolean
        startFuelLevelPercentage:
          type: number
          format: float
        endFuelLevelPercentage:
          type: number
          format: float
        startEngineHours:
          type: number
          format: float
        endEngineHours:
          type: number
          format: float
        private:
          type: boolean
        endDate:
          type: string
          format: date-time
        startDate:
          type: string
          format: date-time
        assetHierarchyNodeId:
          type: string
        personHierarchyNodeId:
          type: string
    Asset:
      type: object
      properties:
        id:
          type: string
        customerId:
          type: string
        registration:
          type: string
        name:
          type: string
        vin:
          type: string
        assetType:
          type: string
        make:
          type: string
        model:
          type: string
        version:
          type: string
        visible:
          type: boolean
        defaultDriverId:
          type: string
        tempDriverId:
          type: string
        tempDriverExpiry:
          type: string
          format: date-time
        tempDriverNextJourneyOnly:
          type: boolean
        litresPer100KmBenchmark:
          $ref: '#/components/schemas/LitresPer100KmBenchmark'
        manualOdometerReading:
          $ref: '#/components/schemas/OdometerReading'
        currentOdometer:
          $ref: '#/components/schemas/OdometerReading'
        cumulativeRuntimeSeconds:
          type: integer
          format: int64
        cumulativePtoRuntimeSeconds:
          type: integer
          format: int64
        cumulativeIdleTimeSeconds:
          type: integer
          format: int64
        cumulativeRuntimeSecondsLastModified:
          type: string
          format: date-time
        cumulativeFuelUsed:
          type: number
          format: double
        vehicle:
          $ref: '#/components/schemas/EcoTaxVehicleParameters'
        assetFeatureTags:
          uniqueItems: true
          type: array
          items:
            type: string
            enum:
              - TRACK
              - PING
              - BATTERY
              - WIRED
              - DRIVERKEY
              - GENERICINPUTS
              - PTO
              - GRITTING
              - SERVICE
              - DEFECTS
              - TRUE_ENGINE_IDLING
              - NO_IDLING
              - SUSPLUS
              - SERVICE_CAN
              - MOBILEDEVICE
              - FAULT_MBOX_200
              - FAULT_MBOX_201
              - FAULT_MBOX_205
              - FAULT_MBOX_207
              - FAULT_MBOX_210
              - FAULT_MBOX_211
              - FAULT_MBOX_214
              - FAULT_MBOX_216
              - FAULT_MBOX_217
              - FAULT_MBOX_218
              - FAULT_MBOX_219
              - FAULT_MBOX_220
              - FAULT_MBOX_222
              - FAULT_MBOX_223
              - FAULT_MBOX_226
              - FAULT_MBOX_227
              - TACHO_BVFM
              - WATEA
              - DOOR
              - UNTRACKED
              - LIGHT_BAR
        historicAssetFeatureTags:
          uniqueItems: true
          type: array
          items:
            type: string
            enum:
              - TRACK
              - PING
              - BATTERY
              - WIRED
              - DRIVERKEY
              - GENERICINPUTS
              - PTO
              - GRITTING
              - SERVICE
              - DEFECTS
              - TRUE_ENGINE_IDLING
              - NO_IDLING
              - SUSPLUS
              - SERVICE_CAN
              - MOBILEDEVICE
              - FAULT_MBOX_200
              - FAULT_MBOX_201
              - FAULT_MBOX_205
              - FAULT_MBOX_207
              - FAULT_MBOX_210
              - FAULT_MBOX_211
              - FAULT_MBOX_214
              - FAULT_MBOX_216
              - FAULT_MBOX_217
              - FAULT_MBOX_218
              - FAULT_MBOX_219
              - FAULT_MBOX_220
              - FAULT_MBOX_222
              - FAULT_MBOX_223
              - FAULT_MBOX_226
              - FAULT_MBOX_227
              - TACHO_BVFM
              - WATEA
              - DOOR
              - UNTRACKED
              - LIGHT_BAR
        tags:
          uniqueItems: true
          type: array
          items:
            type: string
        nextService:
          $ref: '#/components/schemas/NextService'
        serviceHistory:
          type: array
          items:
            $ref: '#/components/schemas/ServiceHistory'
        defects:
          type: array
          items:
            $ref: '#/components/schemas/Defect'
        makeModelVersion:
          type: string
        interestedParties:
          uniqueItems: true
          type: array
          items:
            type: string
        interestedPartyTags:
          uniqueItems: true
          type: array
          items:
            type: string
        yearOfManufacture:
          type: integer
          format: int32
        ownershipStartDate:
          type: string
          format: date
        ownershipEndDate:
          type: string
          format: date
        purchaseCost:
          type: number
        monthlyLeaseCost:
          type: number
        monthlyInsuranceCost:
          type: number
        monthlyMaintenanceCost:
          type: number
        scheduledMaintenanceAmount:
          type: number
        unscheduledMaintenanceAmount:
          type: number
        monthlyFuelCost:
          type: number
        mileageAuthorised:
          type: integer
          format: int32
        costPerMileOverLimit:
          type: number
        costOfDisposal:
          type: number
        buyoutAmount:
          type: number
        costCurrency:
          type: object
          properties:
            currencyCode:
              type: string
            displayName:
              type: string
            symbol:
              type: string
            defaultFractionDigits:
              type: integer
              format: int32
            numericCode:
              type: integer
              format: int32
            numericCodeAsString:
              type: string
        status:
          type: string
          enum:
            - IN_CIRCULATION
            - IN_MAINTENANCE
            - SOLD
        dateStatusChange:
          type: string
          format: date-time
        primaryFuelSource:
          $ref: '#/components/schemas/FuelSource'
        secondaryFuelSource:
          $ref: '#/components/schemas/FuelSource'
        peripherals:
          type: array
          items:
            $ref: '#/components/schemas/Peripheral'
        enginePowerKW:
          type: number
          format: double
        boxType:
          type: string
        boxTypes:
          uniqueItems: true
          type: array
          items:
            type: string
        distributionId:
          type: integer
          format: int32
        secondaryFuelType:
          type: string
          enum:
            - PETROL
            - DIESEL
            - METHANE
            - PROPANE
            - HYDROGEN
            - ELECTRIC
        energy:
          type: string
          enum:
            - ICE
            - EV
            - HEV
            - PHEV
            - CNG
            - LNG
            - LPG
            - FCEV
            - BI_FUEL
            - UNDEFINED
        electricVehicleCompatibility:
          $ref: '#/components/schemas/ElectricVehicleCompatibility'
        assetTypeGroup:
          type: string
        lastManualEngineHoursUpdate:
          type: string
          format: date-time
        weightSettings:
          $ref: '#/components/schemas/AssetWeightSettings'
        dimensionSettings:
          $ref: '#/components/schemas/AssetDimensionSettings'
        usageSettings:
          $ref: '#/components/schemas/AssetUsageSettings'
        brakeSettings:
          $ref: '#/components/schemas/AssetBrakeSettings'
        rpmBandThresholds:
          $ref: '#/components/schemas/AssetRPMThresholds'
        isDriverIdentification:
          type: boolean
        isPrivacy:
          type: boolean
        lastService:
          $ref: '#/components/schemas/ServiceHistory'
        previousService:
          $ref: '#/components/schemas/ServiceHistory'
        manualService:
          type: boolean
        tempDriverIdRaw:
          type: string
        tempDriverExpiryRaw:
          type: string
          format: date-time
        tempDriverNextJourneyOnlyRaw:
          type: boolean
        estimateBatteryLevelPercent:
          type: boolean
        estimateConsumption:
          type: boolean
        estimateRange:
          type: boolean
    LitresPer100KmBenchmark:
      type: object
      properties:
        kms:
          type: number
          format: double
        litres:
          type: number
          format: double
        litresPer100Km:
          type: number
          format: double
    OdometerReading:
      type: object
      properties:
        kms:
          type: number
          format: double
        readingDateTime:
          type: string
          format: date-time
        type:
          type: string
          enum:
            - CAN
            - GPS
            - DO_NOT_APPLY_ODOMETER_FILTER
            - ALL_WITH_ODOMETERS
        odometerKmsLastModified:
          type: string
          format: date-time
    EcoTaxVehicleParameters:
      type: object
      properties:
        ecoTaxApplicable:
          type: boolean
        vehicleWeight:
          type: number
          format: double
        euroEngine:
          type: integer
          format: int32
        numberOfAxles:
          type: integer
          format: int32
        fuelType:
          type: string
    NextService:
      type: object
      properties:
        kmsToService:
          type: number
          format: float
        daysToService:
          type: number
          format: float
        estimatedKmsPerDay:
          type: integer
          format: int32
        dueKms:
          type: number
          format: double
        overdue:
          type: boolean
        dueDate:
          type: string
          format: date-time
        dueDateSource:
          type: string
          enum:
            - VEHICLE
            - ESTIMATE
        updatedDateTime:
          type: string
          format: date-time
        referenceDueDate:
          type: string
          format: date-time
        firstJourneyDueKms:
          type: integer
          format: int32
        firstJourneyDate:
          type: string
          format: date-time
        manualEntry:
          type: boolean
        manualDueDate:
          type: string
          format: date-time
    ServiceHistory:
      type: object
      properties:
        dueKms:
          type: number
          format: double
        serviceDate:
          type: string
          format: date-time
        updatedDateTime:
          type: string
          format: date-time
        serviceOdometer:
          type: number
          format: double
        serviceDueDate:
          type: string
          format: date-time
        overdue:
          type: boolean
        manualEntry:
          type: boolean
    Defect:
      type: object
      properties:
        code:
          type: string
        type:
          type: string
        status:
          type: string
        eventDateTime:
          type: string
          format: date-time
        details:
          type: object
          additionalProperties:
            type: object
    FuelSource:
      type: object
      properties:
        fuelType:
          type: string
          enum:
            - PETROL
            - DIESEL
            - METHANE
            - PROPANE
            - HYDROGEN
            - ELECTRIC
        fuelCapacity:
          type: number
          format: float
        averageConsumption:
          type: number
          format: float
        averageRangeKm:
          type: number
          format: float
    Peripheral:
      type: object
      properties:
        value:
          type: string
        type:
          type: string
    ElectricVehicleCompatibility:
      type: object
      properties:
        estimateBatteryLevelPercent:
          type: boolean
        estimateRange:
          type: boolean
        estimateConsumption:
          type: boolean
        estimateSecondaryConsumption:
          type: boolean
    AssetWeightSettings:
      type: object
      properties:
        unladenWeightKg:
          type: number
          format: double
        maxGrossWeightKg:
          type: number
          format: double
    AssetDimensionSettings:
      type: object
      properties:
        heightMeters:
          type: number
          format: double
        lengthMeters:
          type: number
          format: double
        widthMeters:
          type: number
          format: double
    AssetUsageSettings:
      type: object
      properties:
        usageHoursPerDay:
          type: number
          format: double
        usageDaysPerWeek:
          type: array
          items:
            type: integer
            format: int32
        profitabilityDistanceKm:
          type: number
          format: double
        stoppedThresholdHours:
          type: number
          format: double
    AssetBrakeSettings:
      type: object
      properties:
        absPer100Km:
          type: number
          format: double
        brakingPer100Km:
          type: number
          format: double
    AssetRPMThresholds:
      type: object
      properties:
        blueRPMBand:
          type: integer
          format: int32
        yellow1RPMBand:
          type: integer
          format: int32
        greenRPMBand:
          type: integer
          format: int32
        yellow2RPMBand:
          type: integer
          format: int32
        redRPMBand:
          type: integer
          format: int32
        extraRPMBand:
          type: integer
          format: int32
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````