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

# Distance Travelled

> Returns the distance travelled (in kilometres) by a vehicle for all journeys where the journey started within the period. The end date for the journey does not have to be within the period. The distance travelled on private journeys that started in the period is included.<br/><br/>If groupIds is specified, then the distance travelled by all the vehicles in the specified groups are included in the output. Either vehicleIds or groupIds can be specified as an input parameter, an error is returned if both are specified.



## OpenAPI

````yaml https://api.connectedfleet.michelin.com/vehicle-tracking/api-docs get /public/v1/customer/{customerId}/tracking/journey/summary
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.connectedfleet.michelin.com/vehicle-tracking
    description: Product Server
security:
  - bearerAuth: []
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}/tracking/journey/summary:
    get:
      tags:
        - /tracking/journey
      summary: Distance Travelled
      description: >-
        Returns the distance travelled (in kilometres) by a vehicle for all
        journeys where the journey started within the period. The end date for
        the journey does not have to be within the period. The distance
        travelled on private journeys that started in the period is
        included.<br/><br/>If groupIds is specified, then the distance travelled
        by all the vehicles in the specified groups are included in the output.
        Either vehicleIds or groupIds can be specified as an input parameter, an
        error is returned if both are specified.
      operationId: getJourneySummary
      parameters:
        - name: customerId
          in: path
          required: true
          schema:
            type: string
        - name: startDate
          in: query
          description: >-
            Start date and time for the journey summary period. Format:
            yyyy-MM-dd'T'HH:mm:ss in UTC. Required.
          required: true
          schema:
            type: string
            description: >-
              Start date and time for the journey summary period. Format:
              yyyy-MM-dd'T'HH:mm:ss in UTC. Required.
            format: date-time
        - name: endDate
          in: query
          description: >-
            End date and time for the journey summary period. Format:
            yyyy-MM-dd'T'HH:mm:ss in UTC. Required.
          required: true
          schema:
            type: string
            description: >-
              End date and time for the journey summary period. Format:
              yyyy-MM-dd'T'HH:mm:ss in UTC. Required.
            format: date-time
        - name: vehicleIds
          in: query
          description: List of vehicle identifiers to retrieve journey summary for
          required: false
          schema:
            type: array
            description: List of vehicle identifiers to retrieve journey summary for
            items:
              type: string
        - name: groupIds
          in: query
          description: >-
            List of group identifiers to retrieve journey summary for vehicles
            in those groups
          required: false
          schema:
            type: array
            description: >-
              List of group identifiers to retrieve journey summary for vehicles
              in those groups
            items:
              type: string
      responses:
        '200':
          description: Successful operation
          content:
            application/json;charset=UTF-8:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TrackingJourneySummaryResultDto'
        '400':
          description: Invalid request parameters or validation errors.
        '404':
          description: Vehicle or driver not found.
components:
  schemas:
    TrackingJourneySummaryResultDto:
      type: object
      properties:
        assetRegistration:
          type: string
          description: Registration number of the vehicle
        assetId:
          type: string
          description: Unique identifier of the vehicle
        assetName:
          type: string
          description: Name of the vehicle
        groupName:
          type: string
          description: Name of the vehicle's group
        distance:
          type: number
          description: Total distance traveled in kilometers
          format: double
        odometerType:
          type: string
          description: Type of odometer used for distance measurement
      description: >-
        Journey summary information containing vehicle details and aggregated
        journey metrics
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````