Time Series
The following endpoints allow you to retrieve the data history (positions, daily usages, fault codes...) of a single machine.
Returns all data available for one dataKind for specific equipment. It's the time series mindset of the ISO/AEMP standard.
ID of the equipment
Any of data kinds (activities, averageDailyEngineLoadFactor, batteryLevel, batteryVoltage, deviceBatteryVoltage, cumulativeActiveRegenerationHours, cumulativeDistance, cumulativeFuel, cumulativeIdleHours, cumulativeLoadCount, cumulativeOperatingHours, cumulativePayloadTotal, cumulativePowerTakeOffHours, cumulativeUsageHours, dailyCO2, dailyDistance, dailyLoadCount, dailyPayload, dailyUsages, defRemainingRatio, deviceBatteryLevel, engineCondition, engineCoolantTemperature, engineLoadPercentage, evBatteryHealth, evBatteryLevel, evEnergyUsed, faults, fuelRemaining, peakDailySpeed, positions, sensorBoolean, temperature)
Fetch the data since this date. Expected format is 'YYYY-MM-DDTHH:mm:ssZ'
Beginning of yesterday UTCFetch the data until this date. Expected format is 'YYYY-MM-DDTHH:mm:ssZ'
End of today UTCGET /v2/fleet/equipments/{id}/{dataKind} HTTP/1.1
Host: api.hiboo.io
x-access-token: YOUR_API_KEY
Accept: */*
{
"data": {
"total": 1,
"rows": [
{
"percent": 88.24,
"date": "2025-07-13T16:10:25.058Z"
}
],
"id": 1,
"serialNumber": "YVR001988",
"since": "2019-11-06T00:00:00Z",
"until": "2019-11-20T23:59:59Z"
}
}Returns the details of single machine and its history (positions, daily usages, fault codes)
ID of the equipment
Fetch the data since this date. Expected format is 'YYYY-MM-DDTHH:mm:ssZ'
Beginning of yesterday UTCFetch the data until this date. Expected format is 'YYYY-MM-DDTHH:mm:ssZ'
End of today UTCGET /v2/fleet/equipments/{id}/history HTTP/1.1
Host: api.hiboo.io
x-access-token: YOUR_API_KEY
Accept: */*
{
"data": {
"id": 1,
"name": "D8000-1",
"make": "Caterpillar",
"model": "8000",
"serialNumber": "YVR001988",
"positions": {
"total": 1,
"rows": [
{
"latitude": 48.858269,
"longitude": 2.29447,
"date": "2025-07-13T16:10:25.058Z"
}
]
},
"faultCodes": {
"total": 1,
"rows": [
{
"levelLabel": "unknown",
"severity": -1,
"identifier": "text",
"description": "text",
"date": "2025-07-13T16:10:25.058Z"
}
]
},
"fuelRemainings": {
"total": 1,
"rows": [
{
"percent": 88.24,
"date": "2025-07-13T16:10:25.058Z"
}
]
},
"engineConditions": {
"total": 1,
"rows": [
{
"running": true,
"date": "2025-07-13T16:10:25.058Z"
}
]
},
"dailyUsages": {
"total": 1,
"rows": [
{
"date": "2025-07-13T16:10:25.058Z",
"operatingHours": {
"hour": 8.3
},
"idleHours": {
"hour": 1.5
},
"workingHours": {
"hour": 6.8
},
"fuelUsed": {
"fuelUsed": 99.7,
"unit": "L"
},
"dailyDistance": {
"odometer": 54.2,
"unit": "km"
},
"cumulativeIdleHours": {
"hour": 1064.6
},
"cumulativeOperatingHours": {
"hour": 1064.6
},
"cumulativeFuelUsed": {
"fuelUsed": 9520.5,
"unit": "L"
},
"cumulativeDistance": {
"odometer": 5423.9,
"unit": "km"
},
"cumulativeLoadCount": {
"count": 13569
},
"cumulativePayloadTotal": {
"payload": 447839.9,
"payloadUnit": "tonnes"
},
"cumulativeActiveRegenerationHours": {
"hour": 10.92
},
"cumulativePowerTakeOffHours": {
"hour": 31.21
},
"peakDailySpeed": {
"speed": 14.91,
"speedUnit": "km/h"
},
"averageDailyEngineLoadFactor": {
"percent": 35.9
},
"DEFRemainingRatio": {
"percent": 62,
"tankCapacity": 41,
"tankCapacityUnit": "L"
},
"co2": {
"weight": 123,
"unit": "kg"
}
}
]
}
}
}⚠️ 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.
Fetch the data since this date. Expected format is 'YYYY-MM-DDTHH:mm:ssZ'
Beginning of yesterday UTCFetch the data until this date. Expected format is 'YYYY-MM-DDTHH:mm:ssZ'
End of today UTCThe numbers of items to return
20The number of items to skip before starting to collect the result set
0GET /v2/fleet/equipments/history HTTP/1.1
Host: api.hiboo.io
x-access-token: YOUR_API_KEY
Accept: */*
{
"data": {
"total": 1,
"since": "2019-11-06T00:00:00Z",
"until": "2019-11-20T23:59:59Z",
"rows": [
{
"id": 1,
"name": "D8000-1",
"make": "Caterpillar",
"model": "8000",
"serialNumber": "YVR001988",
"positions": {
"total": 1,
"rows": [
{
"latitude": 48.858269,
"longitude": 2.29447,
"date": "2025-07-13T16:10:25.058Z"
}
]
},
"faultCodes": {
"total": 1,
"rows": [
{
"severity": -1,
"identifier": "text",
"description": "text",
"date": "2025-07-13T16:10:25.058Z"
}
]
},
"fuelRemainings": {
"total": 1,
"rows": [
{
"percent": 88.24,
"date": "2025-07-13T16:10:25.058Z"
}
]
},
"engineConditions": {
"total": 1,
"rows": [
{
"running": true,
"date": "2025-07-13T16:10:25.058Z"
}
]
},
"dailyUsages": {
"total": 1,
"rows": [
{
"date": "2025-07-13T16:10:25.058Z",
"operatingHours": {
"hour": 8.3
},
"idleHours": {
"hour": 1.5
},
"workingHours": {
"hour": 6.8
},
"fuelUsed": {
"fuelUsed": 99.7,
"unit": "L"
},
"dailyDistance": {
"odometer": 54.2,
"unit": "km"
},
"cumulativeIdleHours": {
"hour": 1064.6
},
"cumulativeOperatingHours": {
"hour": 1064.6
},
"cumulativeFuelUsed": {
"fuelUsed": 9520.5,
"unit": "L"
},
"cumulativeDistance": {
"odometer": 5423.9,
"unit": "km"
},
"cumulativeLoadCount": {
"count": 13569
},
"cumulativePayloadTotal": {
"payload": 447839.9,
"payloadUnit": "tonnes"
},
"cumulativeActiveRegenerationHours": {
"hour": 10.92
},
"cumulativePowerTakeOffHours": {
"hour": 31.21
},
"peakDailySpeed": {
"speed": 14.91,
"speedUnit": "km/h"
},
"averageDailyEngineLoadFactor": {
"percent": 35.9
},
"DEFRemainingRatio": {
"percent": 62,
"tankCapacity": 41,
"tankCapacityUnit": "L"
}
}
]
}
}
]
}
}