GET api/telemetry/history/{recordid}?include={include}

View all telemetry data that has been received since a specific record number. Up to 1000 records can be requested at a time.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
recordid

The record id from which to return data.

integer

Required

include

Optional. A comma-separated string containing the types of auxiliary information to return along with the telemetry data.

string

Default value is

Body Parameters

None.

Response Information

Resource Description

TelemetryEventWrapper
NameDescriptionTypeAdditional information
Events

TelemetryRecord array containing upto 1000 events from the specified record id.

Collection of TelemetryRecord

None.

NextRecordID

The RecordID to be used in the next call of this method.

integer

None.

EventCount

The number of events returned in this call.

integer

None.

Response Formats

application/json, text/json

Sample:
{
  "Events": [
    {
      "RecordID": 1,
      "UTCTime": "2025-05-09T13:02:09.0255136+01:00",
      "LocalTime": "2025-05-09T13:02:09.0255136+01:00",
      "DeviceIMEI": "sample string 4",
      "AssetName": "sample string 5",
      "AssetDriver": "sample string 6",
      "AssetTractor": "sample string 7",
      "AssetTrailer": "sample string 8",
      "Ignition": true,
      "GPSLock": true,
      "Latitude": 1.0,
      "Longitude": 1.0,
      "Heading": 1.0,
      "GPSSpeed": 1.0,
      "GPSSpeedUnit": 0,
      "POIName": "sample string 9",
      "RingFenceName": "sample string 10",
      "Location": {
        "Road": "sample string 1",
        "District": "sample string 2",
        "Town": "sample string 3",
        "Region": "sample string 4",
        "County": "sample string 5",
        "Country": "sample string 6",
        "Postcode": "sample string 7",
        "SpeedLimit": 8.0,
        "SpeedLimitUnit": 0
      },
      "Input1": true,
      "Input2": true,
      "Input3": true,
      "Input4": true,
      "AccelerometerData": {
        "AccelerationForce": 1.0,
        "BrakingForce": 1.0,
        "CorneringForce": 1.0
      },
      "CANbusData": {
        "RPM": 1,
        "CoolantTemperature": 1,
        "ThrottlePercent": 1.0,
        "EngineLoadPercent": 1.0,
        "DTCCount": 64,
        "MILActived": true,
        "Odometer": 1.0,
        "OdometerUnit": 0,
        "PTOStatus": "sample string 1",
        "CruiseControlStatus": "sample string 2",
        "AxleWeight": 1.0,
        "ServiceDistance": 1.0,
        "ServiceDistanceUnit": 0,
        "FuelUsed": 1.0,
        "FuelLevelPercent": 1.0,
        "VehicleSpeed": 64,
        "VehicleSpeedUnit": 0,
        "OilTemperature": 1,
        "ServiceBrake": true,
        "ParkingBrake": true,
        "SelectedGear": "sample string 3",
        "AdBlueLevelPercent": 1.0
      },
      "KeyfobTachoCard": "sample string 11",
      "EconData": {
        "RecordID": 1,
        "UtcTime": "2025-05-09T13:02:09.0255136+01:00",
        "LocalTime": "2025-05-09T13:02:09.0255136+01:00",
        "DeviceImei": "sample string 2",
        "AssetName": "sample string 3",
        "EconControlOn": true,
        "EconNoSaltFlow": true,
        "EconSpotGritActive": true,
        "EconManual": true,
        "EconPreWetActive": true,
        "EconSpinnerSelectorPosition": 9,
        "EconRateSelectorPosition": 10,
        "EconPloughActive": true
      },
      "EngineRunningHours": 1.1,
      "BrakeWearData": {
        "FrontLeftWheel": 1.1,
        "FrontRightWheel": 1.1,
        "RearLeftWheel1": 1.1,
        "RearRightWheel1": 1.1,
        "RearLeftWheel2": 1.1,
        "RearRightWheel2": 1.1,
        "RearLeftWheel3": 1.1,
        "RearRightWheel3": 1.1
      },
      "AcceleratorPositionReadings": [
        {
          "Sequence": 1,
          "AcceleratorPosition": 2.1
        },
        {
          "Sequence": 1,
          "AcceleratorPosition": 2.1
        }
      ],
      "TyreSystemData": {
        "SystemConfigs": [
          {
            "NumberOfAxles": 1,
            "NumberOfTtms": 2,
            "Id": 3,
            "PingRecordId": 4,
            "AssetType": 5
          },
          {
            "NumberOfAxles": 1,
            "NumberOfTtms": 2,
            "Id": 3,
            "PingRecordId": 4,
            "AssetType": 5
          }
        ],
        "SystemEvents": [
          {
            "SystemStatus": 1,
            "TtmMounted": true,
            "SingleWheelExchanges": true,
            "AutomaticTrailerLeaningStatus": 4,
            "Id": 5,
            "PingRecordId": 6,
            "AssetType": 7
          },
          {
            "SystemStatus": 1,
            "TtmMounted": true,
            "SingleWheelExchanges": true,
            "AutomaticTrailerLeaningStatus": 4,
            "Id": 5,
            "PingRecordId": 6,
            "AssetType": 7
          }
        ],
        "TyreConfigs": [
          {
            "ActivelyBroadcasting": true,
            "GraphicalPosition": "sample string 2",
            "TyreLocation": "sample string 3",
            "TtmId": "sample string 4",
            "TyreId": 5,
            "Id": 6,
            "PingRecordId": 7,
            "AssetType": 8
          },
          {
            "ActivelyBroadcasting": true,
            "GraphicalPosition": "sample string 2",
            "TyreLocation": "sample string 3",
            "TtmId": "sample string 4",
            "TyreId": 5,
            "Id": 6,
            "PingRecordId": 7,
            "AssetType": 8
          }
        ],
        "TyreEvents": [
          {
            "Alarm": 1,
            "Fault": 2,
            "TtmState": 3,
            "TyreId": 4,
            "Id": 5,
            "PingRecordId": 6,
            "AssetType": 7
          },
          {
            "Alarm": 1,
            "Fault": 2,
            "TtmState": 3,
            "TyreId": 4,
            "Id": 5,
            "PingRecordId": 6,
            "AssetType": 7
          }
        ],
        "TyreStatus": [
          {
            "Pressure": 1.1,
            "Temperature": 2,
            "TyreId": 3,
            "Id": 4,
            "PingRecordId": 5,
            "AssetType": 6
          },
          {
            "Pressure": 1.1,
            "Temperature": 2,
            "TyreId": 3,
            "Id": 4,
            "PingRecordId": 5,
            "AssetType": 6
          }
        ]
      },
      "RefrigeratorBaseData": {
        "PingRecordId": 1,
        "Temperatures": [
          1.1,
          1.1
        ]
      },
      "WasteChassisDennisEvData": {
        "PingRecordId": 1,
        "EngineSpeedRPM": 2.1,
        "DriveDemandEngineTorqueRatio": 3.1,
        "ActualEngineTorqueRatio": 4.1,
        "CoolantTemperatureCelcius": 64,
        "EngineOilTemperatureCelcius": 6.1,
        "ActualHydraulicsEngineTorqueRatio": 7.1,
        "HydraulicsEngineSpeedRPM": 8.1,
        "TransmsissionSelectedGear": 64,
        "TransmissionCurrentGear": 64,
        "TransmissionRequestedRange": "sample string 11",
        "TransmissionCurrentRange": "sample string 12",
        "MaximumHVBatteryVoltage": 13.1,
        "MinimumHVBatteryVoltage": 14.1,
        "MaximumHVChargeCurrent": 15,
        "MaximumHVDischargeCurrent": 16,
        "StateOfCharge": 17.1,
        "HVBusVoltage": 18.1,
        "TotalBatteryHVCurrent": 19,
        "ChargeStatus": 64,
        "ChargeCableConnected": true,
        "DrivePowerLimitationDueToStateOfCharge": true,
        "BatterySystemStatus": {
          "BatteryStatusId": 1,
          "BatteryStatusDescription": "sample string 2",
          "HasIcon": true
        },
        "DriveSystemVoltage": 23.1,
        "DriveSystemCurrent": 24,
        "SensorObjs": [
          {
            "Sensor": {
              "SensorId": 1,
              "SensorName": "sample string 2"
            },
            "SensorValues": [
              {
                "SensorValueId": 1,
                "SensorValueByteValue": 64,
                "SensorValueDescription": "sample string 3",
                "IsErrorValue": true,
                "IsWarningValue": true
              },
              {
                "SensorValueId": 1,
                "SensorValueByteValue": 64,
                "SensorValueDescription": "sample string 3",
                "IsErrorValue": true,
                "IsWarningValue": true
              }
            ]
          },
          {
            "Sensor": {
              "SensorId": 1,
              "SensorName": "sample string 2"
            },
            "SensorValues": [
              {
                "SensorValueId": 1,
                "SensorValueByteValue": 64,
                "SensorValueDescription": "sample string 3",
                "IsErrorValue": true,
                "IsWarningValue": true
              },
              {
                "SensorValueId": 1,
                "SensorValueByteValue": 64,
                "SensorValueDescription": "sample string 3",
                "IsErrorValue": true,
                "IsWarningValue": true
              }
            ]
          }
        ],
        "BatteryStatuses": [
          {
            "BatteryId": 1,
            "StateOfCharge": 2.1,
            "BatteryStatus": {
              "BatteryStatusId": 1,
              "BatteryStatusDescription": "sample string 2",
              "HasIcon": true
            }
          },
          {
            "BatteryId": 1,
            "StateOfCharge": 2.1,
            "BatteryStatus": {
              "BatteryStatusId": 1,
              "BatteryStatusDescription": "sample string 2",
              "HasIcon": true
            }
          }
        ]
      },
      "OverloadProtectionData": {
        "FrontAxlePercent": 1,
        "RearAxlePercent": 2,
        "GrossVehiclePercent": 3,
        "FrontAxleStatus": "sample string 4",
        "RearAxleStatus": "sample string 5",
        "GrossVehicleStatus": "sample string 6"
      },
      "BinLiftData": {
        "TransactionNumber": 1,
        "LiftType": "sample string 2",
        "BinTagCode": "sample string 3",
        "LiftWeight": 4.0,
        "SiteWeight": 5,
        "LiftComment": "sample string 6"
      },
      "HyzonData": {
        "TankVolumeTotal": 2.1,
        "IsolationValue": 7,
        "PowerFuelCell": 13,
        "FuelCellRunHours": 27,
        "StateOfChargeBattery": 29
      }
    },
    {
      "RecordID": 1,
      "UTCTime": "2025-05-09T13:02:09.0255136+01:00",
      "LocalTime": "2025-05-09T13:02:09.0255136+01:00",
      "DeviceIMEI": "sample string 4",
      "AssetName": "sample string 5",
      "AssetDriver": "sample string 6",
      "AssetTractor": "sample string 7",
      "AssetTrailer": "sample string 8",
      "Ignition": true,
      "GPSLock": true,
      "Latitude": 1.0,
      "Longitude": 1.0,
      "Heading": 1.0,
      "GPSSpeed": 1.0,
      "GPSSpeedUnit": 0,
      "POIName": "sample string 9",
      "RingFenceName": "sample string 10",
      "Location": {
        "Road": "sample string 1",
        "District": "sample string 2",
        "Town": "sample string 3",
        "Region": "sample string 4",
        "County": "sample string 5",
        "Country": "sample string 6",
        "Postcode": "sample string 7",
        "SpeedLimit": 8.0,
        "SpeedLimitUnit": 0
      },
      "Input1": true,
      "Input2": true,
      "Input3": true,
      "Input4": true,
      "AccelerometerData": {
        "AccelerationForce": 1.0,
        "BrakingForce": 1.0,
        "CorneringForce": 1.0
      },
      "CANbusData": {
        "RPM": 1,
        "CoolantTemperature": 1,
        "ThrottlePercent": 1.0,
        "EngineLoadPercent": 1.0,
        "DTCCount": 64,
        "MILActived": true,
        "Odometer": 1.0,
        "OdometerUnit": 0,
        "PTOStatus": "sample string 1",
        "CruiseControlStatus": "sample string 2",
        "AxleWeight": 1.0,
        "ServiceDistance": 1.0,
        "ServiceDistanceUnit": 0,
        "FuelUsed": 1.0,
        "FuelLevelPercent": 1.0,
        "VehicleSpeed": 64,
        "VehicleSpeedUnit": 0,
        "OilTemperature": 1,
        "ServiceBrake": true,
        "ParkingBrake": true,
        "SelectedGear": "sample string 3",
        "AdBlueLevelPercent": 1.0
      },
      "KeyfobTachoCard": "sample string 11",
      "EconData": {
        "RecordID": 1,
        "UtcTime": "2025-05-09T13:02:09.0255136+01:00",
        "LocalTime": "2025-05-09T13:02:09.0255136+01:00",
        "DeviceImei": "sample string 2",
        "AssetName": "sample string 3",
        "EconControlOn": true,
        "EconNoSaltFlow": true,
        "EconSpotGritActive": true,
        "EconManual": true,
        "EconPreWetActive": true,
        "EconSpinnerSelectorPosition": 9,
        "EconRateSelectorPosition": 10,
        "EconPloughActive": true
      },
      "EngineRunningHours": 1.1,
      "BrakeWearData": {
        "FrontLeftWheel": 1.1,
        "FrontRightWheel": 1.1,
        "RearLeftWheel1": 1.1,
        "RearRightWheel1": 1.1,
        "RearLeftWheel2": 1.1,
        "RearRightWheel2": 1.1,
        "RearLeftWheel3": 1.1,
        "RearRightWheel3": 1.1
      },
      "AcceleratorPositionReadings": [
        {
          "Sequence": 1,
          "AcceleratorPosition": 2.1
        },
        {
          "Sequence": 1,
          "AcceleratorPosition": 2.1
        }
      ],
      "TyreSystemData": {
        "SystemConfigs": [
          {
            "NumberOfAxles": 1,
            "NumberOfTtms": 2,
            "Id": 3,
            "PingRecordId": 4,
            "AssetType": 5
          },
          {
            "NumberOfAxles": 1,
            "NumberOfTtms": 2,
            "Id": 3,
            "PingRecordId": 4,
            "AssetType": 5
          }
        ],
        "SystemEvents": [
          {
            "SystemStatus": 1,
            "TtmMounted": true,
            "SingleWheelExchanges": true,
            "AutomaticTrailerLeaningStatus": 4,
            "Id": 5,
            "PingRecordId": 6,
            "AssetType": 7
          },
          {
            "SystemStatus": 1,
            "TtmMounted": true,
            "SingleWheelExchanges": true,
            "AutomaticTrailerLeaningStatus": 4,
            "Id": 5,
            "PingRecordId": 6,
            "AssetType": 7
          }
        ],
        "TyreConfigs": [
          {
            "ActivelyBroadcasting": true,
            "GraphicalPosition": "sample string 2",
            "TyreLocation": "sample string 3",
            "TtmId": "sample string 4",
            "TyreId": 5,
            "Id": 6,
            "PingRecordId": 7,
            "AssetType": 8
          },
          {
            "ActivelyBroadcasting": true,
            "GraphicalPosition": "sample string 2",
            "TyreLocation": "sample string 3",
            "TtmId": "sample string 4",
            "TyreId": 5,
            "Id": 6,
            "PingRecordId": 7,
            "AssetType": 8
          }
        ],
        "TyreEvents": [
          {
            "Alarm": 1,
            "Fault": 2,
            "TtmState": 3,
            "TyreId": 4,
            "Id": 5,
            "PingRecordId": 6,
            "AssetType": 7
          },
          {
            "Alarm": 1,
            "Fault": 2,
            "TtmState": 3,
            "TyreId": 4,
            "Id": 5,
            "PingRecordId": 6,
            "AssetType": 7
          }
        ],
        "TyreStatus": [
          {
            "Pressure": 1.1,
            "Temperature": 2,
            "TyreId": 3,
            "Id": 4,
            "PingRecordId": 5,
            "AssetType": 6
          },
          {
            "Pressure": 1.1,
            "Temperature": 2,
            "TyreId": 3,
            "Id": 4,
            "PingRecordId": 5,
            "AssetType": 6
          }
        ]
      },
      "RefrigeratorBaseData": {
        "PingRecordId": 1,
        "Temperatures": [
          1.1,
          1.1
        ]
      },
      "WasteChassisDennisEvData": {
        "PingRecordId": 1,
        "EngineSpeedRPM": 2.1,
        "DriveDemandEngineTorqueRatio": 3.1,
        "ActualEngineTorqueRatio": 4.1,
        "CoolantTemperatureCelcius": 64,
        "EngineOilTemperatureCelcius": 6.1,
        "ActualHydraulicsEngineTorqueRatio": 7.1,
        "HydraulicsEngineSpeedRPM": 8.1,
        "TransmsissionSelectedGear": 64,
        "TransmissionCurrentGear": 64,
        "TransmissionRequestedRange": "sample string 11",
        "TransmissionCurrentRange": "sample string 12",
        "MaximumHVBatteryVoltage": 13.1,
        "MinimumHVBatteryVoltage": 14.1,
        "MaximumHVChargeCurrent": 15,
        "MaximumHVDischargeCurrent": 16,
        "StateOfCharge": 17.1,
        "HVBusVoltage": 18.1,
        "TotalBatteryHVCurrent": 19,
        "ChargeStatus": 64,
        "ChargeCableConnected": true,
        "DrivePowerLimitationDueToStateOfCharge": true,
        "BatterySystemStatus": {
          "BatteryStatusId": 1,
          "BatteryStatusDescription": "sample string 2",
          "HasIcon": true
        },
        "DriveSystemVoltage": 23.1,
        "DriveSystemCurrent": 24,
        "SensorObjs": [
          {
            "Sensor": {
              "SensorId": 1,
              "SensorName": "sample string 2"
            },
            "SensorValues": [
              {
                "SensorValueId": 1,
                "SensorValueByteValue": 64,
                "SensorValueDescription": "sample string 3",
                "IsErrorValue": true,
                "IsWarningValue": true
              },
              {
                "SensorValueId": 1,
                "SensorValueByteValue": 64,
                "SensorValueDescription": "sample string 3",
                "IsErrorValue": true,
                "IsWarningValue": true
              }
            ]
          },
          {
            "Sensor": {
              "SensorId": 1,
              "SensorName": "sample string 2"
            },
            "SensorValues": [
              {
                "SensorValueId": 1,
                "SensorValueByteValue": 64,
                "SensorValueDescription": "sample string 3",
                "IsErrorValue": true,
                "IsWarningValue": true
              },
              {
                "SensorValueId": 1,
                "SensorValueByteValue": 64,
                "SensorValueDescription": "sample string 3",
                "IsErrorValue": true,
                "IsWarningValue": true
              }
            ]
          }
        ],
        "BatteryStatuses": [
          {
            "BatteryId": 1,
            "StateOfCharge": 2.1,
            "BatteryStatus": {
              "BatteryStatusId": 1,
              "BatteryStatusDescription": "sample string 2",
              "HasIcon": true
            }
          },
          {
            "BatteryId": 1,
            "StateOfCharge": 2.1,
            "BatteryStatus": {
              "BatteryStatusId": 1,
              "BatteryStatusDescription": "sample string 2",
              "HasIcon": true
            }
          }
        ]
      },
      "OverloadProtectionData": {
        "FrontAxlePercent": 1,
        "RearAxlePercent": 2,
        "GrossVehiclePercent": 3,
        "FrontAxleStatus": "sample string 4",
        "RearAxleStatus": "sample string 5",
        "GrossVehicleStatus": "sample string 6"
      },
      "BinLiftData": {
        "TransactionNumber": 1,
        "LiftType": "sample string 2",
        "BinTagCode": "sample string 3",
        "LiftWeight": 4.0,
        "SiteWeight": 5,
        "LiftComment": "sample string 6"
      },
      "HyzonData": {
        "TankVolumeTotal": 2.1,
        "IsolationValue": 7,
        "PowerFuelCell": 13,
        "FuelCellRunHours": 27,
        "StateOfChargeBattery": 29
      }
    }
  ],
  "NextRecordID": 1,
  "EventCount": 2
}