GET apioauth/v4/assetjourneysummary?assetID={assetID}&from={from}&to={to}

Get a journey summary by asset id

Request Information

URI Parameters

Name	Description	Type	Additional information
assetID	The asset id being queried	unsigned integer	Required
from	The start date being queried yyyyMMddHHmmss	string	Required
to	The end date being queried yyyyMMddHHmmss	string	Required

Body Parameters

None.

Response Information

Resource Description

A JourneySummaryAsset

JourneySummaryAsset

Name	Description	Type	Additional information
AssetID	The ID of the asset which made the journey	unsigned integer	None.
ServiceID	The ID of the Service which made the journey	unsigned integer	None.
SummaryType	The type of the summary	JourneySummaryType	None.
StartDate	The start date of the summary	date	None.
EndDate	The end date of the summary	date	None.
FirstJourneyStartDate	The start date of the first journey	date	None.
LastJourneyEndDate	The end date of the last journey	date	None.
Duration	The duration of the all journeys in seconds	unsigned integer	None.
IdleTime	The journey idle time in seconds during all the journeys	unsigned integer	None.
MaxIdleInstance	The maximum period of idling during all the journeys	unsigned integer	None.
DistanceMeters	The distance traveled in meters during the journeys	unsigned integer	None.
StartLat	The start latitude of the first journey	decimal number	None.
StartLong	The start longitude of the first journey	decimal number	None.
StartStreet	The start street of the first journey	string	None.
StartTown	The start town of the first journey	string	None.
StartCountry	The start country of the first journey	string	None.
StartPOI	The start POI of the first journey	string	None.
StartPostcode	The start postcode of the first journey	string	None.
EndLat	The end latitude of the last journey	decimal number	None.
EndLong	The end longitude of the last journey	decimal number	None.
EndStreet	The end street of the last journey	string	None.
EndTown	The end town of the last journey	string	None.
EndCountry	The end country of the last journey	string	None.
EndPOI	The end POI of the last journey	string	None.
EndPostcode	The end post code of the last journey	string	None.
RpmEvents	The number of RPM events seen during the journeys	unsigned integer	None.
RpmMax	The maximum RPM value seen during the journeys	unsigned integer	None.
RpmLevel1Count	The number of RPM level 1 events during the journeys	unsigned integer	None.
RpmLevel2Count	The number of RPM level 2 events during the journeys	unsigned integer	None.
RpmLevel3Count	The number of RPM level 3 events during the journeys	unsigned integer	None.
RpmLevel4Count	The number of RPM level 4 events during the journeys	unsigned integer	None.
RpmLevel5Count	The number of RPM level 5 events during the journeys	unsigned integer	None.
RpmLevel6Count	The number of RPM level 6 events during the journeys	unsigned integer	None.
AccelEvents	The amount of acceleration events during the journeys	unsigned integer	None.
AccelMax	The maximum acceleration instance during the journeys	decimal number	None.
AccelLowCount	The amount of low level acceleration events during the journeys	unsigned integer	None.
AccelMediumCount	The amount of medium level acceleration events during the journeys	unsigned integer	None.
AccelHighCount	The amount of high level acceleration events during the journeys	unsigned integer	None.
DecelEvents	The amount of deceleration events during the journeys	unsigned integer	None.
DecelMax	The maximum deceleration instance during the journeys	decimal number	None.
DecelLowCount	The amount of low level deceleration events during the journeys	unsigned integer	None.
DecelMediumCount	The amount of medium level deceleration events during the journeys	unsigned integer	None.
DecelHighCount	The amount of high level deceleration events during the journeys	unsigned integer	None.
SpeedEvents	The number of speeding events during the journeys	unsigned integer	None.
SpeedMax	The maximum speed during the journeys	decimal number	None.
Speed15Count		unsigned integer	None.
Speed45Count		unsigned integer	None.
Speed55Count		unsigned integer	None.
Speed65Count		unsigned integer	None.
Speed20Count	The number of speeding events in 20 mph zones during the journeys	unsigned integer	None.
Speed30Count	The number of speeding events in 30 mph zones during the journeys	unsigned integer	None.
Speed40Count	The number of speeding events in 40 mph zones during the journeys	unsigned integer	None.
Speed50Count	The number of speeding events in 50 mph zones during the journeys	unsigned integer	None.
Speed60Count	The number of speeding events in 60 mph zones during the journeys	unsigned integer	None.
Speed70Count	The number of speeding events in 70 mph zones during the journeys	unsigned integer	None.
DeadzoneTime	The night time driving score in seconds during the journey	unsigned integer	None.
UrbanDistance	The urban distance driven during the journey	unsigned integer	None.
CO2	The CO2 used in the journey	decimal number	None.
Input0Distance	The distance driven with input 0 active	unsigned integer	None.
Input1Distance	The distance driven with input 1 active	unsigned integer	None.
Input2Distance	The distance driven with input 2 active	unsigned integer	None.
Input3Distance	The distance driven with input 3 active	unsigned integer	None.
Input0Duration	The duration in seconds when input 0 was active	unsigned integer	None.
Input1Duration	The duration in seconds when input 1 was active	unsigned integer	None.
Input2Duration	The duration in seconds when input 2 was active	unsigned integer	None.
Input3Duration	The duration in seconds when input 3 was active	unsigned integer	None.
ActionDistance	The distance driven with the action state active	unsigned integer	None.
ActionDuration	The duration in seconds when the action state was active	unsigned integer	None.
StartVoltage	The vehicle battery voltage at the start of the first journey	decimal number	None.
EndVoltage	The vehicle battery voltage at the end of the last journey	decimal number	None.
WaterUsed	Water used during the journeys if applicable	decimal number	None.
AreaCleaned	The area cleaned during the journeys if applicable	decimal number	None.
StartFuelPercentage	The start fuel percentage from the first journey	decimal number	None.
EndFuelPercentage	The end fuel percentage from the last journey	decimal number	None.
StartFuelLitre	The start fuel level from the first journey	decimal number	None.
EndFuelLitre	The end fuel level from the last journey	decimal number	None.
TotalFuelUsed	The fuel used in litres	decimal number	None.
JourneyCount	The number of journeys completed	unsigned integer	None.
IdlingJourneyCount	The number of journeys idling	unsigned integer	None.
MaximumJourneyDistance	The maximum journey distance in meters	unsigned integer	None.
MinimumJourneyDistance	The minimum journey distance in meters	unsigned integer	None.
MaximumJourneyDuration	The maximum journey duration in seconds	unsigned integer	None.
MinimumJourneyDuration	The minimum journey duration in seconds	unsigned integer	None.
ReportingAssets	if summarising for more than one vehicle, the count of vehicles that reported in during the selected time	integer	None.
Previous16WeeksWorkingTime	The total working time for the previous 16 weeks, this is only populated on weekly records	unsigned integer	None.
CurrentPeriodWorkingTime	The current period working time, this is only populated on the daily and weekly records	unsigned integer	None.

Response Formats

application/json, text/json

Sample:

{
  "AssetID": 1,
  "ServiceID": 2,
  "SummaryType": 0,
  "StartDate": "2025-04-27T16:37:12.6619755+00:00",
  "EndDate": "2025-04-27T16:37:12.6619755+00:00",
  "FirstJourneyStartDate": "2025-04-27T16:37:12.6619755+00:00",
  "LastJourneyEndDate": "2025-04-27T16:37:12.6619755+00:00",
  "Duration": 7,
  "IdleTime": 8,
  "MaxIdleInstance": 9,
  "DistanceMeters": 10,
  "StartLat": 11.1,
  "StartLong": 12.1,
  "StartStreet": "sample string 13",
  "StartTown": "sample string 14",
  "StartCountry": "sample string 15",
  "StartPOI": "sample string 16",
  "StartPostcode": "sample string 17",
  "EndLat": 18.1,
  "EndLong": 19.1,
  "EndStreet": "sample string 20",
  "EndTown": "sample string 21",
  "EndCountry": "sample string 22",
  "EndPOI": "sample string 23",
  "EndPostcode": "sample string 24",
  "RpmEvents": 25,
  "RpmMax": 26,
  "RpmLevel1Count": 27,
  "RpmLevel2Count": 28,
  "RpmLevel3Count": 29,
  "RpmLevel4Count": 30,
  "RpmLevel5Count": 31,
  "RpmLevel6Count": 32,
  "AccelEvents": 33,
  "AccelMax": 34.1,
  "AccelLowCount": 35,
  "AccelMediumCount": 36,
  "AccelHighCount": 37,
  "DecelEvents": 38,
  "DecelMax": 39.1,
  "DecelLowCount": 40,
  "DecelMediumCount": 41,
  "DecelHighCount": 42,
  "SpeedEvents": 43,
  "SpeedMax": 44.1,
  "Speed15Count": 45,
  "Speed45Count": 46,
  "Speed55Count": 47,
  "Speed65Count": 48,
  "Speed20Count": 49,
  "Speed30Count": 50,
  "Speed40Count": 51,
  "Speed50Count": 52,
  "Speed60Count": 53,
  "Speed70Count": 54,
  "DeadzoneTime": 55,
  "UrbanDistance": 56,
  "CO2": 57.1,
  "Input0Distance": 58,
  "Input1Distance": 59,
  "Input2Distance": 60,
  "Input3Distance": 61,
  "Input0Duration": 62,
  "Input1Duration": 63,
  "Input2Duration": 64,
  "Input3Duration": 65,
  "ActionDistance": 66,
  "ActionDuration": 67,
  "StartVoltage": 68.1,
  "EndVoltage": 69.1,
  "WaterUsed": 70.1,
  "AreaCleaned": 71.1,
  "StartFuelPercentage": 72.1,
  "EndFuelPercentage": 73.1,
  "StartFuelLitre": 74.1,
  "EndFuelLitre": 75.1,
  "TotalFuelUsed": 76.1,
  "JourneyCount": 77,
  "IdlingJourneyCount": 78,
  "MaximumJourneyDistance": 79,
  "MinimumJourneyDistance": 80,
  "MaximumJourneyDuration": 81,
  "MinimumJourneyDuration": 82,
  "ReportingAssets": 83,
  "Previous16WeeksWorkingTime": 84,
  "CurrentPeriodWorkingTime": 85
}

application/xml, text/xml

Sample:

<JourneySummaryAsset xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <AssetID>1</AssetID>
  <ServiceID>2</ServiceID>
  <SummaryType>daily</SummaryType>
  <StartDate>2025-04-27T16:37:12.6619755+00:00</StartDate>
  <EndDate>2025-04-27T16:37:12.6619755+00:00</EndDate>
  <FirstJourneyStartDate>2025-04-27T16:37:12.6619755+00:00</FirstJourneyStartDate>
  <LastJourneyEndDate>2025-04-27T16:37:12.6619755+00:00</LastJourneyEndDate>
  <Duration>7</Duration>
  <IdleTime>8</IdleTime>
  <MaxIdleInstance>9</MaxIdleInstance>
  <DistanceMeters>10</DistanceMeters>
  <StartLat>11.1</StartLat>
  <StartLong>12.1</StartLong>
  <StartStreet>sample string 13</StartStreet>
  <StartTown>sample string 14</StartTown>
  <StartCountry>sample string 15</StartCountry>
  <StartPOI>sample string 16</StartPOI>
  <StartPostcode>sample string 17</StartPostcode>
  <EndLat>18.1</EndLat>
  <EndLong>19.1</EndLong>
  <EndStreet>sample string 20</EndStreet>
  <EndTown>sample string 21</EndTown>
  <EndCountry>sample string 22</EndCountry>
  <EndPOI>sample string 23</EndPOI>
  <EndPostcode>sample string 24</EndPostcode>
  <RpmEvents>25</RpmEvents>
  <RpmMax>26</RpmMax>
  <RpmLevel1Count>27</RpmLevel1Count>
  <RpmLevel2Count>28</RpmLevel2Count>
  <RpmLevel3Count>29</RpmLevel3Count>
  <RpmLevel4Count>30</RpmLevel4Count>
  <RpmLevel5Count>31</RpmLevel5Count>
  <RpmLevel6Count>32</RpmLevel6Count>
  <AccelEvents>33</AccelEvents>
  <AccelMax>34.1</AccelMax>
  <AccelLowCount>35</AccelLowCount>
  <AccelMediumCount>36</AccelMediumCount>
  <AccelHighCount>37</AccelHighCount>
  <DecelEvents>38</DecelEvents>
  <DecelMax>39.1</DecelMax>
  <DecelLowCount>40</DecelLowCount>
  <DecelMediumCount>41</DecelMediumCount>
  <DecelHighCount>42</DecelHighCount>
  <SpeedEvents>43</SpeedEvents>
  <SpeedMax>44.1</SpeedMax>
  <Speed15Count>45</Speed15Count>
  <Speed45Count>46</Speed45Count>
  <Speed55Count>47</Speed55Count>
  <Speed65Count>48</Speed65Count>
  <Speed20Count>49</Speed20Count>
  <Speed30Count>50</Speed30Count>
  <Speed40Count>51</Speed40Count>
  <Speed50Count>52</Speed50Count>
  <Speed60Count>53</Speed60Count>
  <Speed70Count>54</Speed70Count>
  <DeadzoneTime>55</DeadzoneTime>
  <UrbanDistance>56</UrbanDistance>
  <CO2>57.1</CO2>
  <Input0Distance>58</Input0Distance>
  <Input1Distance>59</Input1Distance>
  <Input2Distance>60</Input2Distance>
  <Input3Distance>61</Input3Distance>
  <Input0Duration>62</Input0Duration>
  <Input1Duration>63</Input1Duration>
  <Input2Duration>64</Input2Duration>
  <Input3Duration>65</Input3Duration>
  <ActionDistance>66</ActionDistance>
  <ActionDuration>67</ActionDuration>
  <StartVoltage>68.1</StartVoltage>
  <EndVoltage>69.1</EndVoltage>
  <WaterUsed>70.1</WaterUsed>
  <AreaCleaned>71.1</AreaCleaned>
  <StartFuelPercentage>72.1</StartFuelPercentage>
  <EndFuelPercentage>73.1</EndFuelPercentage>
  <StartFuelLitre>74.1</StartFuelLitre>
  <EndFuelLitre>75.1</EndFuelLitre>
  <TotalFuelUsed>76.1</TotalFuelUsed>
  <JourneyCount>77</JourneyCount>
  <IdlingJourneyCount>78</IdlingJourneyCount>
  <MaximumJourneyDistance>79</MaximumJourneyDistance>
  <MinimumJourneyDistance>80</MinimumJourneyDistance>
  <MaximumJourneyDuration>81</MaximumJourneyDuration>
  <MinimumJourneyDuration>82</MinimumJourneyDuration>
  <ReportingAssets>83</ReportingAssets>
  <Previous16WeeksWorkingTime>84</Previous16WeeksWorkingTime>
  <CurrentPeriodWorkingTime>85</CurrentPeriodWorkingTime>
</JourneySummaryAsset>