> ## 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. # Live Position Latest > Returns the live position and status for a resource (driver or vehicle). The live position for a vehicle on a private journey is not returned. By default vehicles which have a status of SOLD are not included in the response.

This endpoint can be used to return details for only those vehicles where tracking data has been processed since a specified processed date/time as follows:If vehicleIds, driverIds or groupIds are not specified, then the live position for all vehicles is returned. If driverIds is specified, then the driver must be recorded against their vehicle for their live position to be returned. If groupIds is specified, then the current position for all drivers/vehicles in the specified groups are included in the output. Only one of vehicleIds, driverIds or groupIds can be specified as an input parameter.

If fromDateTime is specified, then only vehicles where tracking information has been processed since the specified date/time are included in the output response. An error is returned if the value specified for fromDateTime is more than one day in the past. No details are returned if the value specified for fromDateTime is a future date.

Request Limit:
The request limit on this endpoint is one request every 15 seconds. You will receive an HTTP status code of 429 (too many requests) and no details will be returned if you exceed this restriction. ## OpenAPI ````yaml /api-reference/vehicle-tracking.json get /public/v1/customer/{customerId}/tracking/live/latest 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}/tracking/live/latest: get: tags: - /tracking/live summary: Live Position Latest description: >- Returns the live position and status for a resource (driver or vehicle). The live position for a vehicle on a private journey is not returned. By default vehicles which have a status of SOLD are not included in the response.

This endpoint can be used to return details for only those vehicles where tracking data has been processed since a specified processed date/time as follows:If vehicleIds, driverIds or groupIds are not specified, then the live position for all vehicles is returned. If driverIds is specified, then the driver must be recorded against their vehicle for their live position to be returned. If groupIds is specified, then the current position for all drivers/vehicles in the specified groups are included in the output. Only one of vehicleIds, driverIds or groupIds can be specified as an input parameter.

If fromDateTime is specified, then only vehicles where tracking information has been processed since the specified date/time are included in the output response. An error is returned if the value specified for fromDateTime is more than one day in the past. No details are returned if the value specified for fromDateTime is a future date.

Request Limit:
The request limit on this endpoint is one request every 15 seconds. You will receive an HTTP status code of 429 (too many requests) and no details will be returned if you exceed this restriction. operationId: getLatestLiveStatus parameters: - name: customerId in: path required: true schema: type: string - name: vehicleIds in: query description: Comma separated list of vehicle identifiers (alphanumeric). required: false schema: type: array description: Comma separated list of vehicle identifiers (alphanumeric). items: type: string - name: groupIds in: query description: Comma separated list of group ids. required: false schema: type: array description: Comma separated list of group ids. items: type: string - name: driverIds in: query description: Comma separated list of driver identifiers (alphanumeric). required: false schema: type: array description: Comma separated list of driver identifiers (alphanumeric). items: type: string - name: fromDateTime in: query description: Start date and time for the tracking data retrieval required: false schema: type: string description: Start date and time for the tracking data retrieval format: date-time - name: showAllVehicleStatus in: query description: >- Boolean (true/false) to indicate if details of all vehicles should be included, irrespective of their status. If not specified, defaults to FALSE, so vehicles with a status of SOLD are excluded from the response. required: false schema: type: boolean description: >- Boolean (true/false) to indicate if details of all vehicles should be included, irrespective of their status. If not specified, defaults to FALSE, so vehicles with a status of SOLD are excluded from the response. - name: locale in: query description: Locale for the response data. required: false schema: type: string description: Locale for the response data. - name: hideSpeedIfSpeedSensitive in: query description: >- Boolean (true/false) to indicate if the vehicle speed should be excluded from the output if the driver;'s group (if there is a driver for the vehicle) or the vehicle's group has been defined to be speed sensitive. If not specified, defaults to FALSE, so the vehicle's speed is included in the response. required: false schema: type: boolean description: >- Boolean (true/false) to indicate if the vehicle speed should be excluded from the output if the driver;'s group (if there is a driver for the vehicle) or the vehicle's group has been defined to be speed sensitive. If not specified, defaults to FALSE, so the vehicle's speed is included in the response. responses: '200': description: Latest live position data successfully returned content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/LatestTrackingLiveResultsDto' '400': description: >- fromDateTime is more than one day in the past or is a future date, or multiple filter options provided content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/ApiErrorDto' components: schemas: LatestTrackingLiveResultsDto: type: object properties: items: type: array description: Array of vehicle position details. items: $ref: '#/components/schemas/TrackingLiveResultDto' 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 totalCount: type: integer description: Total number of items that matched the search parameters. format: int32 example: 1 ApiErrorDto: type: object properties: errorCode: type: integer format: int32 errorMessage: type: string offendingFields: type: array items: type: string TrackingLiveResultDto: type: object properties: assetRegistration: type: string description: Registration of the asset. assetName: type: string description: Friendly name of the asset. assetVin: type: string description: The vehicle identification number (VIN) of the asset. assetId: type: string description: >- Unique, unchangeable system generated identifier (alphanumeric) for the asset. driverId: type: string description: >- Unique, unchangeable system generated identifier (alphanumeric) for the driver. driverName: type: string description: Name of the driver of the vehicle. driverGroupId: type: string description: >- Unique, unchangeable system generated identifier (alphanumeric) for the group the driver has been assigned to. driverGroupName: type: string description: Name of the group the driver has been assigned to. assetGroupId: type: string description: >- Unique, unchangeable system generated identifier (alphanumeric) for the group the asset has been assigned to. assetGroupName: type: string description: Name of the group the asset has been assigned to. date: type: string description: Date and time of the tracking event. format: date-time status: type: string description: >- The most recent tracking event received from the vehicle. Can be one of the following: eventType: type: string description: >- Category for the most recent tracking event status of the vehicle. Can be one of the following: speed: type: number description: >- The current speed of the vehicle (in kph). Not included if optional input parameter hideSpeedIfSpeedSensitive was set to true. format: double odometer: type: number description: >- Odometer (in km) for the latest tracking event that has been received. format: double heading: type: number description: >- Compass heading of the vehicle in degrees clockwise from north. For example: North = 0, East = 90, South = 180 and West = 270. format: double latitude: type: number description: Asset latitude position. format: double longitude: type: number description: Asset longitude position. format: double road: type: string description: The name of the road where the asset is. roadNumber: type: string description: The road number where the asset is. city: type: string description: The name of the city where the asset is. postCode: type: string description: The postcode where the asset is. country: type: string description: The name of the country where the asset is. formattedAddress: type: string description: >- Country specific formatted address as a comma separated values using roadNumber, road, city, postcode and country. For example, division: type: string description: >- The region / county / State from the address. For example: Normandy, Worcestershire, Tuscany, Arizona locationName: type: string description: >- Name of a POI location if the vehicle is within the geo-fence boundary of a POI location. locationGroupName: type: string description: The name of the location category assigned to this POI location. locationId: type: string description: The identifier (alphanumeric) for the POI location. inputs: type: array description: Array of inputs. items: $ref: '#/components/schemas/InputLive' inputEvents: type: array description: Array of input events items: $ref: '#/components/schemas/TrackingLiveInputEventOverviewDto' privacy: type: boolean description: >- Boolean (true / false) to indicate if the journey is a private journey. tags: uniqueItems: true type: array description: Comma separated list of tags for the asset. items: type: string description: Comma separated list of tags for the asset. assetType: type: string description: Asset type, for example, BUS, CAR, CAR_ESTATE, CAR_SPORTS etc. energyType: type: string description: >- The energy type for the vehicle. Can be one of the following: fuelType: type: array description: >- A list of the primary and secondary fuel types for the vehicle. Values in the list can included: items: type: string description: >- A list of the primary and secondary fuel types for the vehicle. Values in the list can included: electricRangeKm: type: number description: >- The range for an electric vehicle based on the electric vehicle battery level percentage. format: float electricRangeKmEstimated: type: boolean description: >- Boolean (true/false) if the range was estimated - true if estimated, false if received from the vehicle. electricBatteryLevelPercent: type: number description: The electric vehicle battery level as a percentage. format: float electricBatteryLevelPercentEstimated: type: boolean description: >- Boolean (true/false) if the electric vehicle battery level was estimated - true if estimated, false if received from the vehicle. electricCharging: type: boolean description: >- Boolean (true/false) if the electric vehicle battery is being charged - true if being charged, false otherwise. electricChargingTimeRemainingMins: type: number description: >- Remaining minutes until the electric vehicle battery is fully charged. format: float fuelLevelLitres: type: number description: >- The fuel level in litres. If fuel level is received then either fuelLevelPercentage or fuelLevelLitres will be returned. format: float fuelLevelPercentage: type: number description: >- The fuel level as a percentage. If fuel level is received then either fuelLevelPercentage or fuelLevelLitres will be returned. format: float engineTotalHours: type: number description: >- Engine hours for the latest tracking event that has been received (format is decimal hours) format: float engineRpm: type: number description: Engine RPM format: float engineTotalHoursType: type: string description: >- Either ESTIMATED or CAN. enum: - CAN - ESTIMATED serialNumber: type: integer description: >- The serial number of the Calamp tracking device on the vehicle that sent this tracking event format: int64 ignitionStatus: type: string description: Ignition status of the vehicle enum: - 'ON' - 'OFF' batteryVoltage: type: number description: Charge level of the battery powering the OBU format: float externalPowerVoltage: type: number description: Charge level of an external power source supplying energy. format: float activeFaultCodes: type: array description: Comma separated list of active fault codes on the vehicle. items: type: string description: Comma separated list of active fault codes on the vehicle. description: Detailed live position and status for a resource InputLive: type: object properties: inputId: type: string inputLabel: type: string inputState: type: string customInputLabel: type: string customInputState: type: string description: Array of inputs. TrackingLiveInputEventOverviewDto: type: object properties: eventDateTime: type: string description: Date and time when the input event occurred. format: date-time eventKey: type: string description: Unique key identifying the type of input event. example: key eventLabel: type: string description: Human-readable label describing the input event. example: label channels: type: array description: List of channels associated with this input event. items: $ref: '#/components/schemas/TrackingLiveInputEventChannelOverviewDto' description: Overview of an input event with channels TrackingLiveInputEventChannelOverviewDto: type: object properties: label: type: string description: Human-readable label for the channel. example: label unit: type: string description: Unit of measurement for the channel value. example: kg value: type: object description: The raw value of the channel (can be numeric or string). example: 10.8 stringValue: type: string description: String representation of the channel value. example: '10.8' order: type: integer description: Order position for display purposes. format: int32 example: 10 groupNumber: type: integer description: Group number for organizing channels. format: int32 key: type: string description: Unique key identifying the channel. example: key coldReadyState: type: boolean description: Boolean indicating if the channel is in cold ready state. description: Channel data within an input event securitySchemes: basicAuth: type: http scheme: basic ````