GET api/telemetry/historyRaw/{assetId}/{startdate}/{enddate}?checkforgaps={checkforgaps}

View a reduced subset of telemetry data - primary use-case is for performance-critical applications.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
assetId

The assetId from the asset endpoint.

integer

Required

startdate

The start date/time (utc time) from which to return data. Format: yyyy-MM-dd HH:mm:ss

date

Required

enddate

The end date/time (utc time) to which data should be returned. If this parameter is omitted then all records from 'startdate' will be returned. Format: yyyy-MM-dd HH:mm:ss

date

None.

checkforgaps

Indicates wether the API should check for gaps in data (ie data is still being downloaded by the device). If this is set to 'true' then the API will only return records for periods where there are no gaps in data. If set to 'false' then the API will return all records currently held in the system even if there are gaps still to be filled.

boolean

Default value is False

Body Parameters

None.

Response Information

Resource Description

Collection of TelemetryRecordRaw
NameDescriptionTypeAdditional information
RecordId

Unique record ID for the telemetry record

integer

None.

AssetId

Unique ID of Asset

integer

None.

UTCTime

The timestamp (UTC) at which the data in this record was captured.

date

None.

Latitude

GPS latitude position (Decimal Degrees)

decimal number

None.

Longitude

GPS longitude position (Decimal Degrees)

decimal number

None.

Speed

Current asset speed (MPH)

decimal number

None.

Heading

GPS compass bearing (Degrees)

decimal number

None.

Odometer

Accumulated distance travelled by the vehicle during its operation (Miles).

decimal number

None.

Response Formats

application/json, text/json

Sample:
[
  {
    "RecordId": 1,
    "AssetId": 2,
    "UTCTime": "2026-03-19T21:56:29.609774+00:00",
    "Latitude": 4.0,
    "Longitude": 5.0,
    "Speed": 6.0,
    "Heading": 7.0,
    "Odometer": 1.0
  },
  {
    "RecordId": 1,
    "AssetId": 2,
    "UTCTime": "2026-03-19T21:56:29.609774+00:00",
    "Latitude": 4.0,
    "Longitude": 5.0,
    "Speed": 6.0,
    "Heading": 7.0,
    "Odometer": 1.0
  }
]

application/xml, text/xml

Sample:
<ArrayOfTelemetryRecordRaw xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <TelemetryRecordRaw>
    <RecordId>1</RecordId>
    <AssetId>2</AssetId>
    <UTCTime>2026-03-19T21:56:29.609774+00:00</UTCTime>
    <Latitude>4</Latitude>
    <Longitude>5</Longitude>
    <Speed>6</Speed>
    <Heading>7</Heading>
    <Odometer>1</Odometer>
  </TelemetryRecordRaw>
  <TelemetryRecordRaw>
    <RecordId>1</RecordId>
    <AssetId>2</AssetId>
    <UTCTime>2026-03-19T21:56:29.609774+00:00</UTCTime>
    <Latitude>4</Latitude>
    <Longitude>5</Longitude>
    <Speed>6</Speed>
    <Heading>7</Heading>
    <Odometer>1</Odometer>
  </TelemetryRecordRaw>
</ArrayOfTelemetryRecordRaw>