MiX Telematics REST API

Event

Represents an event from a vehicle hosted by a MiX Telematics system.

Fields

SystemType
The type of MiX Telematics system that hosts the event.
VehicleId
The identifier of the vehicle in which the event was generated.
DeviceTimestamp
The date/time at which the event was generated (from the device's clock).
ReceivedTimestamp
The date/time at which the event was received by the MiX Telematics servers.
EventType
The type of the event.
DriverId
The identifier of the driver who was driving when the event was generated.
CoDriverId
The identifier of the driver who was the co-driver when the event was generated.
Value
The value associated with the event (e.g. Speed in the case of an Over Speeding event).
Duration
The duration of the event in seconds.
StartPosition
The Position resource representing where and when the event started.
EndPosition
The Position resource representing where and when the event ended.
VideoId
The unique identifier of the video clip that was recorded during the event.

Note: Fields which are not available will be omitted.

Examples

JSON body:

{"SystemType":"AssetManagement","VehicleId":"01554cdd-287e-4c0d-8a17-07ae1c372fda","DeviceTimestamp":"\/Date(1317198572000+0000)\/","ReceivedTimestamp":"\/Date(1317198575073+0000)\/","EventType":"37590e5c-0c5b-4119-83d2-9336f97708b2","Value":0,"StartPosition":{"SystemType":"AssetManagement","VehicleId":"01554cdd-287e-4c0d-8a17-07ae1c372fda","DeviceTimestamp":"\/Date(1317198572000+0000)\/","ReceivedTimestamp":"\/Date(1317198574850+0000)\/","IgnitionOn":false,"Odometer":0,"Longitude":-0.1445675,"Latitude":51.44867,"Speed":0,"Heading":0}}

XML body:

<?xml version="1.0"?>
<EventResource SystemType="AssetManagement" VehicleId="01554cdd-287e-4c0d-8a17-07ae1c372fda">
	<DeviceTimestamp>2011-09-28T08:29:32Z</DeviceTimestamp>
	<ReceivedTimestamp>2011-09-28T08:29:35.073Z</ReceivedTimestamp>
	<EventType>37590e5c-0c5b-4119-83d2-9336f97708b2</EventType>
	<Value>0</Value>
	<StartPosition SystemType="AssetManagement" VehicleId="01554cdd-287e-4c0d-8a17-07ae1c372fda">
		<DeviceTimestamp UtcOffset="0">2011-09-28T08:29:32Z</DeviceTimestamp>
		<ReceivedTimestamp UtcOffset="0">2011-09-28T08:29:34.85Z</ReceivedTimestamp>
		<IgnitionOn>false</IgnitionOn>
		<Odometer>0</Odometer>
		<Longitude>-0.14456749</Longitude>
		<Latitude>51.44867</Latitude>
		<Speed>0</Speed>
		<Heading>0</Heading>
	</StartPosition>
</EventResource>