> For the complete documentation index, see [llms.txt](https://docs.hiboo.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hiboo.io/rest-api-reference/mixed-fleet-data/time-series.md).

# Time Series

The following endpoints allow you to retrieve the data history (positions, daily usages, fault codes...) of a single machine.

## Activity history

> Returns all activities (trips/movements) for a specific piece of equipment.

```json
{"openapi":"3.0.3","info":{"title":"Hiboo API","version":"2.0.0"},"tags":[{"name":"Time Series","description":"The following endpoints allow you to retrieve the data history (positions, daily usages, fault codes...) of a single machine."}],"servers":[{"url":"https://api.hiboo.io","description":"Production server"},{"url":"https://api-sandbox.hiboo.io","description":"Sandbox server"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"apiKey","in":"header","name":"x-access-token","description":"Generate a JWT when you log in. Use it in your following requests in the header as `x-access-token: your-token-here`\n"}},"parameters":{"assetId":{"name":"id","in":"path","description":"ID of the equipment","required":true,"schema":{"type":"integer","format":"int32"}},"since":{"name":"since","in":"query","required":false,"description":"Fetch the data since this date. Expected format is 'YYYY-MM-DDTHH:mm:ssZ'","schema":{"type":"string","format":"date-time","description":"Default is beginning of yesterday UTC"}},"until":{"name":"until","in":"query","required":false,"description":"Fetch the data until this date. Expected format is 'YYYY-MM-DDTHH:mm:ssZ'","schema":{"type":"string","format":"date-time","description":"Default is end of today UTC"}}},"responses":{"activities":{"description":"Time series of activities for a specific asset","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"total":{"type":"number","format":"int64"},"rows":{"type":"array","items":{"type":"object","properties":{"dateStart":{"type":"string","format":"date-time","description":"Start date and time of the activity"},"dateStop":{"type":"string","format":"date-time","description":"End date and time of the activity"},"distanceMeters":{"type":"number","format":"float","description":"Distance traveled during the activity in meters"},"averageSpeedKmH":{"type":"number","format":"float","description":"Average speed during the activity in kilometers per hour"},"firstPositionAddress":{"type":"string","description":"Address of the first recorded position"},"lastPositionAddress":{"type":"string","description":"Address of the last recorded position"}}}},"id":{"type":"integer"},"serialNumber":{"type":"string"},"since":{"type":"string","format":"date-time","description":"The since value actually used"},"until":{"type":"string","format":"date-time","description":"The until value actually used"}}}}}}}},"401Error":{"description":"Unable to authenticate the token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoDetailError"}}}}},"schemas":{"NoDetailError":{"required":["message"],"type":"object","properties":{"message":{"type":"string","description":"A human readable description of the error"}}}}},"paths":{"/v2/fleet/equipments/{id}/activities":{"get":{"operationId":"getFleetEquipmentActivities","summary":"Activity history","description":"Returns all activities (trips/movements) for a specific piece of equipment.","tags":["Time Series"],"parameters":[{"$ref":"#/components/parameters/assetId"},{"$ref":"#/components/parameters/since"},{"$ref":"#/components/parameters/until"}],"responses":{"200":{"$ref":"#/components/responses/activities"},"401":{"$ref":"#/components/responses/401Error"}}}}}}
```

## Fault history

> Returns all fault codes for a specific piece of equipment.

```json
{"openapi":"3.0.3","info":{"title":"Hiboo API","version":"2.0.0"},"tags":[{"name":"Time Series","description":"The following endpoints allow you to retrieve the data history (positions, daily usages, fault codes...) of a single machine."}],"servers":[{"url":"https://api.hiboo.io","description":"Production server"},{"url":"https://api-sandbox.hiboo.io","description":"Sandbox server"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"apiKey","in":"header","name":"x-access-token","description":"Generate a JWT when you log in. Use it in your following requests in the header as `x-access-token: your-token-here`\n"}},"parameters":{"assetId":{"name":"id","in":"path","description":"ID of the equipment","required":true,"schema":{"type":"integer","format":"int32"}},"since":{"name":"since","in":"query","required":false,"description":"Fetch the data since this date. Expected format is 'YYYY-MM-DDTHH:mm:ssZ'","schema":{"type":"string","format":"date-time","description":"Default is beginning of yesterday UTC"}},"until":{"name":"until","in":"query","required":false,"description":"Fetch the data until this date. Expected format is 'YYYY-MM-DDTHH:mm:ssZ'","schema":{"type":"string","format":"date-time","description":"Default is end of today UTC"}}},"responses":{"faults":{"description":"Time series of fault codes for a specific asset","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"total":{"type":"number","format":"int64"},"rows":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date-time","description":"Date and time when the fault was recorded"},"description":{"type":"string","description":"Human-readable description of the fault"},"identifier":{"type":"string","description":"Fault code identifier/label"},"severity":{"type":"integer","description":"Numerical severity level of the fault"},"levelLabel":{"type":"string","description":"Human-readable severity level label"}}}},"id":{"type":"integer"},"serialNumber":{"type":"string"},"since":{"type":"string","format":"date-time","description":"The since value actually used"},"until":{"type":"string","format":"date-time","description":"The until value actually used"}}}}}}}},"401Error":{"description":"Unable to authenticate the token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoDetailError"}}}}},"schemas":{"NoDetailError":{"required":["message"],"type":"object","properties":{"message":{"type":"string","description":"A human readable description of the error"}}}}},"paths":{"/v2/fleet/equipments/{id}/faults":{"get":{"operationId":"getFleetEquipmentFaults","summary":"Fault history","description":"Returns all fault codes for a specific piece of equipment.","tags":["Time Series"],"parameters":[{"$ref":"#/components/parameters/assetId"},{"$ref":"#/components/parameters/since"},{"$ref":"#/components/parameters/until"}],"responses":{"200":{"$ref":"#/components/responses/faults"},"401":{"$ref":"#/components/responses/401Error"}}}}}}
```

## Position history

> Returns all GPS positions for a specific piece of equipment.

```json
{"openapi":"3.0.3","info":{"title":"Hiboo API","version":"2.0.0"},"tags":[{"name":"Time Series","description":"The following endpoints allow you to retrieve the data history (positions, daily usages, fault codes...) of a single machine."}],"servers":[{"url":"https://api.hiboo.io","description":"Production server"},{"url":"https://api-sandbox.hiboo.io","description":"Sandbox server"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"apiKey","in":"header","name":"x-access-token","description":"Generate a JWT when you log in. Use it in your following requests in the header as `x-access-token: your-token-here`\n"}},"parameters":{"assetId":{"name":"id","in":"path","description":"ID of the equipment","required":true,"schema":{"type":"integer","format":"int32"}},"since":{"name":"since","in":"query","required":false,"description":"Fetch the data since this date. Expected format is 'YYYY-MM-DDTHH:mm:ssZ'","schema":{"type":"string","format":"date-time","description":"Default is beginning of yesterday UTC"}},"until":{"name":"until","in":"query","required":false,"description":"Fetch the data until this date. Expected format is 'YYYY-MM-DDTHH:mm:ssZ'","schema":{"type":"string","format":"date-time","description":"Default is end of today UTC"}}},"responses":{"positions":{"description":"Time series of positions for a specific asset","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"total":{"type":"number","format":"int64"},"rows":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date-time","description":"Date and time when the position was recorded"},"latitude":{"type":"number","format":"float","description":"Latitude coordinate in decimal degrees"},"longitude":{"type":"number","format":"float","description":"Longitude coordinate in decimal degrees"},"altitude":{"type":"number","format":"float","nullable":true,"description":"Altitude in meters above sea level"},"speed":{"type":"number","format":"float","nullable":true,"description":"Speed in kilometers per hour"},"heading":{"type":"number","format":"float","nullable":true,"description":"Heading/direction in degrees (0-360)"}}}},"id":{"type":"integer"},"serialNumber":{"type":"string"},"since":{"type":"string","format":"date-time","description":"The since value actually used"},"until":{"type":"string","format":"date-time","description":"The until value actually used"}}}}}}}},"401Error":{"description":"Unable to authenticate the token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoDetailError"}}}}},"schemas":{"NoDetailError":{"required":["message"],"type":"object","properties":{"message":{"type":"string","description":"A human readable description of the error"}}}}},"paths":{"/v2/fleet/equipments/{id}/positions":{"get":{"operationId":"getFleetEquipmentPositions","summary":"Position history","description":"Returns all GPS positions for a specific piece of equipment.","tags":["Time Series"],"parameters":[{"$ref":"#/components/parameters/assetId"},{"$ref":"#/components/parameters/since"},{"$ref":"#/components/parameters/until"}],"responses":{"200":{"$ref":"#/components/responses/positions"},"401":{"$ref":"#/components/responses/401Error"}}}}}}
```

## Data kind history

> Returns time series data for a specific data kind for a piece of equipment.

```json
{"openapi":"3.0.3","info":{"title":"Hiboo API","version":"2.0.0"},"tags":[{"name":"Time Series","description":"The following endpoints allow you to retrieve the data history (positions, daily usages, fault codes...) of a single machine."}],"servers":[{"url":"https://api.hiboo.io","description":"Production server"},{"url":"https://api-sandbox.hiboo.io","description":"Sandbox server"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"apiKey","in":"header","name":"x-access-token","description":"Generate a JWT when you log in. Use it in your following requests in the header as `x-access-token: your-token-here`\n"}},"parameters":{"assetId":{"name":"id","in":"path","description":"ID of the equipment","required":true,"schema":{"type":"integer","format":"int32"}}},"responses":{"SnapshotOfEquipmentDataKind":{"description":"Snapshot of all devices. The shape of each row varies by data kind — this example shows `fuelRemaining`. For `dailyFuel` and `dailyCO2`, rows also include an `estimated` boolean: whether the value was estimated from usage hours × the model's consumption rate, rather than measured from telematics.\n","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"total":{"type":"number","format":"int64"},"rows":{"type":"array","items":{"type":"object","properties":{"percent":{"type":"number","format":"float","description":"Percentage of fuel remaining in the asset's tank.\n"},"date":{"type":"string","format":"date-time"}}}},"id":{"type":"integer"},"serialNumber":{"type":"string"},"since":{"type":"string","format":"date-time","description":"The since value actually used"},"until":{"type":"string","format":"date-time","description":"The until value actually used"}}}}}}}},"401Error":{"description":"Unable to authenticate the token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoDetailError"}}}}},"schemas":{"NoDetailError":{"required":["message"],"type":"object","properties":{"message":{"type":"string","description":"A human readable description of the error"}}}}},"paths":{"/v2/fleet/equipments/{id}/{dataKind}":{"get":{"operationId":"getFleetEquipmentDataKindByEquipmentId","summary":"Data kind history","description":"Returns time series data for a specific data kind for a piece of equipment.","tags":["Time Series"],"parameters":[{"$ref":"#/components/parameters/assetId"},{"name":"dataKind","in":"path","description":"Data kind identifier.","required":true,"schema":{"type":"string","enum":["activities","averageDailyEngineLoadFactor","batteryLevel","batteryVoltage","cumulativeActiveRegenerationHours","cumulativeDistance","cumulativeFuel","cumulativeIdleFuel","cumulativeIdleHours","cumulativeLoadCount","cumulativeOperatingHours","cumulativePayloadTotal","cumulativePowerTakeOffHours","dailyCO2","dailyDistance","dailyEvEnergyUsed","dailyIdleFuel","dailyLoadCount","dailyPayload","dailyUsages","defRemainingRatio","deviceBatteryLevel","deviceBatteryVoltage","engineCondition","engineCoolantTemperature","engineLoadPercentage","evBatteryChargeCyclesCount","evBatteryCurrent","evBatteryHealth","evBatteryLevel","evBatteryTemperature","evBatteryVoltage","evChargingRate","evChargingState","evDischargingRate","evEnergyCharged","evEnergyUsed faults","fuelRemaining","peakDailySpeed","positions","sensorBoolean","temperature"]}},{"name":"since","in":"query","required":false,"description":"Fetch the data since this date. Expected format is 'YYYY-MM-DDTHH:mm:ssZ'","schema":{"type":"string","format":"date-time","description":"Default is beginning of yesterday UTC"}},{"name":"until","in":"query","required":false,"description":"Fetch the data until this date. Expected format is 'YYYY-MM-DDTHH:mm:ssZ'","schema":{"type":"string","format":"date-time","description":"Default is end of today UTC"}}],"responses":{"200":{"$ref":"#/components/responses/SnapshotOfEquipmentDataKind"},"401":{"$ref":"#/components/responses/401Error"}}}}}}
```

## Daily history

> Returns comprehensive daily history for a piece of equipment including positions, usage, and fault codes.

```json
{"openapi":"3.0.3","info":{"title":"Hiboo API","version":"2.0.0"},"tags":[{"name":"Time Series","description":"The following endpoints allow you to retrieve the data history (positions, daily usages, fault codes...) of a single machine."}],"servers":[{"url":"https://api.hiboo.io","description":"Production server"},{"url":"https://api-sandbox.hiboo.io","description":"Sandbox server"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"apiKey","in":"header","name":"x-access-token","description":"Generate a JWT when you log in. Use it in your following requests in the header as `x-access-token: your-token-here`\n"}},"parameters":{"assetId":{"name":"id","in":"path","description":"ID of the equipment","required":true,"schema":{"type":"integer","format":"int32"}}},"responses":{"EquipmentHistory":{"description":"Specific equipment details with its history","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"make":{"type":"string"},"model":{"type":"string"},"serialNumber":{"type":"string"},"pin":{"type":"string","nullable":true,"description":"Product Identification Number"},"vin":{"type":"string","nullable":true,"description":"Vehicle Identification Number"},"positions":{"type":"object","properties":{"total":{"type":"number","format":"int64"},"rows":{"type":"array","items":{"type":"object","properties":{"latitude":{"type":"number","format":"float"},"longitude":{"type":"number","format":"float"},"date":{"type":"string","format":"date-time"}}}}}},"faultCodes":{"type":"object","properties":{"total":{"type":"number","format":"int64"},"rows":{"type":"array","items":{"type":"object","properties":{"levelLabel":{"type":"string","nullable":true,"enum":["unknown","information","warning","error","critical"]},"severity":{"type":"number","format":"int64","nullable":true,"enum":[-1,0,1,2],"description":"Severity of the error * -1 - Unknown * 0 - Information * 1 - Warning * 2 - Error\n"},"identifier":{"type":"string"},"description":{"type":"string"},"date":{"type":"string","format":"date-time"}}}}}},"fuelRemainings":{"type":"object","properties":{"total":{"type":"number","format":"int64"},"rows":{"type":"array","items":{"type":"object","properties":{"percent":{"type":"number","format":"float","description":"Perentage of fuel remaining in the asset's tank.\n"},"date":{"type":"string","format":"date-time"}}}}}},"engineConditions":{"type":"object","properties":{"total":{"type":"number","format":"int64"},"rows":{"type":"array","items":{"type":"object","properties":{"running":{"type":"boolean","description":"True if engine went from running to stopped. False if engine went from stopped to running.\n"},"date":{"type":"string","format":"date-time"}}}}}},"dailyUsages":{"type":"object","properties":{"total":{"type":"number","format":"int64"},"rows":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date-time"},"operatingHours":{"type":"object","description":"The total number of engine hours on this date","properties":{"hour":{"nullable":true,"type":"number","format":"float"}}},"idleHours":{"type":"object","description":"The total number of idle engine hours on this date","properties":{"hour":{"nullable":true,"type":"number","format":"float"}}},"workingHours":{"type":"object","description":"The total number of \"useful\" e.g. non-idle engine hours on this date","properties":{"hour":{"nullable":true,"type":"number","format":"float"}}},"fuelUsed":{"type":"object","description":"The total of liter of fuel used on this date","properties":{"fuelUsed":{"nullable":true,"type":"number","format":"float"},"unit":{"type":"string"},"estimated":{"nullable":true,"type":"boolean","description":"Whether this value was estimated from usage hours × the model's consumption rate, rather than measured from telematics.\n"}}},"dailyDistance":{"type":"object","description":"Number of kilometers traveled on this date","properties":{"odometer":{"nullable":true,"type":"number","format":"float"},"unit":{"type":"string"}}},"cumulativeIdleHours":{"description":"The last available cumulativeIdleHours of the day or null if none available","type":"object","properties":{"hour":{"type":"number","format":"float","nullable":true}}},"cumulativeOperatingHours":{"description":"The last available cumulativeOperatingHours of the day or null if none available","type":"object","properties":{"hour":{"type":"number","format":"float","nullable":true}}},"cumulativeFuelUsed":{"description":"The last available cumulativeFuelUsed of the day or null if none available","type":"object","properties":{"fuelUsed":{"type":"number","format":"float"},"unit":{"type":"string"}}},"cumulativeDistance":{"description":"The last available cumulativeDistance of the day or null if none available","type":"object","properties":{"odometer":{"type":"number","format":"float"},"unit":{"type":"string"}}},"cumulativeLoadCount":{"description":"The number of cycles performed by the machine.","type":"object","properties":{"count":{"nullable":true,"type":"integer","format":"int64"}}},"cumulativePayloadTotal":{"description":"Total payload lifted, hauled or processed by the machine.","type":"object","properties":{"payload":{"type":"number","format":"float"},"payloadUnit":{"type":"string"}}},"cumulativeActiveRegenerationHours":{"description":"The time when the machine is placed in a non-productive state to complete the regeneration process.","type":"object","properties":{"hour":{"nullable":true,"type":"number","format":"float"}}},"cumulativePowerTakeOffHours":{"type":"object","description":"The time the power take off was driving an implement such as a mower or sprayer.","properties":{"hour":{"nullable":true,"type":"number","format":"float"}}},"peakDailySpeed":{"description":"Used to monitor excessive machine speed to identify machine misuse or underuse.","type":"object","properties":{"speed":{"type":"number","format":"float"},"speedUnit":{"type":"string"}}},"averageDailyEngineLoadFactor":{"description":"The percentage calculated as the actual fuel consumed over the previous 24 h period divided by the fuel that would have been consumed during that period if the machine had been continually operated at the engine’s rated output.","type":"object","properties":{"percent":{"type":"number","format":"float"}}},"DEFRemainingRatio":{"type":"object","properties":{"percent":{"type":"number","format":"float","description":"The percent of DEF — Diesel exhaust fluid — remaining is used to schedule DEF delivery to the vehicle"},"tankCapacity":{"type":"number","format":"float","description":"The maximum capacity of the DEF tank."},"tankCapacityUnit":{"type":"string"}}},"co2":{"description":"Total CO2 emitted by the machine.","type":"object","properties":{"weight":{"type":"number","format":"float"},"unit":{"type":"string"},"estimated":{"nullable":true,"type":"boolean","description":"Whether this value was estimated from usage hours × the model's consumption rate, rather than measured from telematics.\n"}}}}}}}}}}}}}}},"401Error":{"description":"Unable to authenticate the token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoDetailError"}}}}},"schemas":{"NoDetailError":{"required":["message"],"type":"object","properties":{"message":{"type":"string","description":"A human readable description of the error"}}}}},"paths":{"/v2/fleet/equipments/{id}/history":{"get":{"operationId":"getFleetEquipmentHistoryByEquipmentId","summary":"Daily history","description":"Returns comprehensive daily history for a piece of equipment including positions, usage, and fault codes.","tags":["Time Series"],"parameters":[{"$ref":"#/components/parameters/assetId"},{"name":"since","in":"query","required":false,"description":"Fetch the data since this date. Expected format is 'YYYY-MM-DDTHH:mm:ssZ'","schema":{"type":"string","format":"date-time","description":"Default is beginning of yesterday UTC"}},{"name":"until","in":"query","required":false,"description":"Fetch the data until this date. Expected format is 'YYYY-MM-DDTHH:mm:ssZ'","schema":{"type":"string","format":"date-time","description":"Default is end of today UTC"}}],"responses":{"200":{"$ref":"#/components/responses/EquipmentHistory"},"401":{"$ref":"#/components/responses/401Error"}}}}}}
```

## Fleet

> ⚠️ This endpoint will be deprecated and should not be used anymore. Returns the list of all equipments and their history (positions, daily usages, fault codes). This endpoint is paginated.

```json
{"openapi":"3.0.3","info":{"title":"Hiboo API","version":"2.0.0"},"tags":[{"name":"Time Series","description":"The following endpoints allow you to retrieve the data history (positions, daily usages, fault codes...) of a single machine."}],"servers":[{"url":"https://api.hiboo.io","description":"Production server"},{"url":"https://api-sandbox.hiboo.io","description":"Sandbox server"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"apiKey","in":"header","name":"x-access-token","description":"Generate a JWT when you log in. Use it in your following requests in the header as `x-access-token: your-token-here`\n"}},"parameters":{"limit":{"name":"limit","in":"query","description":"The numbers of items to return","required":false,"schema":{"type":"integer","format":"int32","default":20,"maximum":50}},"offset":{"name":"offset","in":"query","description":"The number of items to skip before starting to collect the result set","required":false,"schema":{"type":"integer","format":"int32","default":0}}},"responses":{"EquipmentsHistory":{"description":"List of equipment with their history","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"total":{"type":"integer","format":"int32"},"since":{"type":"string","format":"date-time","description":"The since value actually used"},"until":{"type":"string","format":"date-time","description":"The until value actually used"},"rows":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"make":{"type":"string"},"model":{"type":"string"},"serialNumber":{"type":"string"},"positions":{"type":"object","properties":{"total":{"type":"number","format":"int64"},"rows":{"type":"array","items":{"type":"object","properties":{"latitude":{"type":"number","format":"float"},"longitude":{"type":"number","format":"float"},"date":{"type":"string","format":"date-time"}}}}}},"faultCodes":{"type":"object","properties":{"total":{"type":"number","format":"int64"},"rows":{"type":"array","items":{"type":"object","properties":{"severity":{"type":"number","format":"int64","nullable":true,"enum":[-1,0,1,2],"description":"Severity of the error * -1 - Unknown * 0 - Information * 1 - Warning * 2 - Error\n"},"identifier":{"type":"string"},"description":{"type":"string"},"date":{"type":"string","format":"date-time"}}}}}},"fuelRemainings":{"type":"object","properties":{"total":{"type":"number","format":"int64"},"rows":{"type":"array","items":{"type":"object","properties":{"percent":{"type":"number","format":"float","description":"Perentage of fuel remaining in the asset's tank.\n"},"date":{"type":"string","format":"date-time"}}}}}},"engineConditions":{"type":"object","properties":{"total":{"type":"number","format":"int64"},"rows":{"type":"array","items":{"type":"object","properties":{"running":{"type":"boolean","description":"True if engine went from running to stopped. False if engine went from stopped to running.\n"},"date":{"type":"string","format":"date-time"}}}}}},"dailyUsages":{"type":"object","properties":{"total":{"type":"number","format":"int64"},"rows":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date-time"},"operatingHours":{"type":"object","description":"The total number of engine hours on this date","properties":{"hour":{"nullable":true,"type":"number","format":"float"}}},"idleHours":{"type":"object","description":"The total number of idle engine hours on this date","properties":{"hour":{"nullable":true,"type":"number","format":"float"}}},"workingHours":{"type":"object","description":"The total number of \"useful\" e.g. non-idle engine hours on this date","properties":{"hour":{"nullable":true,"type":"number","format":"float"}}},"fuelUsed":{"type":"object","description":"The total of liter of fuel used on this date","properties":{"fuelUsed":{"nullable":true,"type":"number","format":"float"},"unit":{"type":"string"}}},"dailyDistance":{"type":"object","description":"Number of kilometers traveled on this date","properties":{"odometer":{"nullable":true,"type":"number","format":"float"},"unit":{"type":"string"}}},"cumulativeIdleHours":{"description":"The last available cumulativeIdleHours of the day or null if none available","type":"object","properties":{"hour":{"type":"number","format":"float","nullable":true}}},"cumulativeOperatingHours":{"description":"The last available cumulativeOperatingHours of the day or null if none available","type":"object","properties":{"hour":{"type":"number","format":"float","nullable":true}}},"cumulativeFuelUsed":{"description":"The last available cumulativeFuelUsed of the day or null if none available","type":"object","properties":{"fuelUsed":{"type":"number","format":"float"},"unit":{"type":"string"}}},"cumulativeDistance":{"description":"The last available cumulativeDistance of the day or null if none available","type":"object","properties":{"odometer":{"type":"number","format":"float"},"unit":{"type":"string"}}},"cumulativeLoadCount":{"description":"The number of cycles performed by the machine.","type":"object","properties":{"count":{"nullable":true,"type":"integer","format":"int64"}}},"cumulativePayloadTotal":{"description":"Total payload lifted, hauled or processed by the machine.","type":"object","properties":{"payload":{"type":"number","format":"float"},"payloadUnit":{"type":"string"}}},"cumulativeActiveRegenerationHours":{"description":"The time when the machine is placed in a non-productive state to complete the regeneration process.","type":"object","properties":{"hour":{"nullable":true,"type":"number","format":"float"}}},"cumulativePowerTakeOffHours":{"type":"object","description":"The time the power take off was driving an implement such as a mower or sprayer.","properties":{"hour":{"nullable":true,"type":"number","format":"float"}}},"peakDailySpeed":{"description":"Used to monitor excessive machine speed to identify machine misuse or underuse.","type":"object","properties":{"speed":{"type":"number","format":"float"},"speedUnit":{"type":"string"}}},"averageDailyEngineLoadFactor":{"description":"The percentage calculated as the actual fuel consumed over the previous 24 h period divided by the fuel that would have been consumed during that period if the machine had been continually operated at the engine’s rated output.","type":"object","properties":{"percent":{"type":"number","format":"float"}}},"DEFRemainingRatio":{"type":"object","properties":{"percent":{"type":"number","format":"float","description":"The percent of DEF — Diesel exhaust fluid — remaining is used to schedule DEF delivery to the vehicle"},"tankCapacity":{"type":"number","format":"float","description":"The maximum capacity of the DEF tank."},"tankCapacityUnit":{"type":"string"}}}}}}}}}}}}}}}}}},"401Error":{"description":"Unable to authenticate the token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoDetailError"}}}}},"schemas":{"NoDetailError":{"required":["message"],"type":"object","properties":{"message":{"type":"string","description":"A human readable description of the error"}}}}},"paths":{"/v2/fleet/equipments/history":{"get":{"deprecated":true,"operationId":"getFleetEquipmentsHistory","summary":"Fleet","description":"⚠️ This endpoint will be deprecated and should not be used anymore. Returns the list of all equipments and their history (positions, daily usages, fault codes). This endpoint is paginated.","tags":["Time Series"],"parameters":[{"name":"since","in":"query","required":false,"description":"Fetch the data since this date. Expected format is 'YYYY-MM-DDTHH:mm:ssZ'","schema":{"type":"string","format":"date-time","description":"Default is beginning of yesterday UTC"}},{"name":"until","in":"query","required":false,"description":"Fetch the data until this date. Expected format is 'YYYY-MM-DDTHH:mm:ssZ'","schema":{"type":"string","format":"date-time","description":"Default is end of today UTC"}},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/offset"}],"responses":{"200":{"$ref":"#/components/responses/EquipmentsHistory"},"401":{"$ref":"#/components/responses/401Error"}}}}}}
```