GET api/econ/history/{asset}/{startdate}/{enddate}?checkforgaps={checkforgaps}&include={include}

View all econ data that has been received for a specific asset since a given time, or between 2 timestamps. Up to 1000 records can be requested at a time.

Request Information

URI Parameters

Name	Description	Type	Additional information
asset	The asset name of the asset to query	string	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
include		string	Default value is

Body Parameters

None.

Response Information

Resource Description

Collection of EconData

Name	Description	Type	Additional information
RecordID	Unique record ID for the Econ record (Use this to join to RecordID in Telmerty data)	integer	None.
UtcTime	The UTC date time of the data	date	None.
LocalTime	The local date time of the data	date	None.
DeviceImei	The unique ID of the telematics device which generated this record.	string	String length: inclusive between 0 and 30
AssetName	The name of the asset to which this data belongs.	string	String length: inclusive between 0 and 30
EconControlOn	The state of the asset's Econ control.	boolean	None.
EconNoSaltFlow	The state of the asset's Econ no salt flow.	boolean	None.
EconSpotGritActive	The state of the asset's Econ spot grit.	boolean	None.
EconManual	The state of the asset's Econ manual.	boolean	None.
EconPreWetActive	The state of the asset's Econ pre wet.	boolean	None.
EconSpinnerSelectorPosition	The asset's Econ spinner selector position	integer	None.
EconRateSelectorPosition	The asset's Econ rate seleector postition	integer	None.
EconPloughActive	The state of the asset's Econ plough.	boolean	None.

Response Formats

application/json, text/json

Sample:

[
  {
    "RecordID": 1,
    "UtcTime": "2025-04-29T18:47:47.2697352+01:00",
    "LocalTime": "2025-04-29T18:47:47.2697352+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
  },
  {
    "RecordID": 1,
    "UtcTime": "2025-04-29T18:47:47.2697352+01:00",
    "LocalTime": "2025-04-29T18:47:47.2697352+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
  }
]

application/xml, text/xml

Sample:

<ArrayOfEconData xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <EconData>
    <RecordID>1</RecordID>
    <UtcTime>2025-04-29T18:47:47.2697352+01:00</UtcTime>
    <LocalTime>2025-04-29T18:47:47.2697352+01:00</LocalTime>
    <DeviceImei>sample string 2</DeviceImei>
    <AssetName>sample string 3</AssetName>
    <EconControlOn>true</EconControlOn>
    <EconNoSaltFlow>true</EconNoSaltFlow>
    <EconSpotGritActive>true</EconSpotGritActive>
    <EconManual>true</EconManual>
    <EconPreWetActive>true</EconPreWetActive>
    <EconSpinnerSelectorPosition>9</EconSpinnerSelectorPosition>
    <EconRateSelectorPosition>10</EconRateSelectorPosition>
    <EconPloughActive>true</EconPloughActive>
  </EconData>
  <EconData>
    <RecordID>1</RecordID>
    <UtcTime>2025-04-29T18:47:47.2697352+01:00</UtcTime>
    <LocalTime>2025-04-29T18:47:47.2697352+01:00</LocalTime>
    <DeviceImei>sample string 2</DeviceImei>
    <AssetName>sample string 3</AssetName>
    <EconControlOn>true</EconControlOn>
    <EconNoSaltFlow>true</EconNoSaltFlow>
    <EconSpotGritActive>true</EconSpotGritActive>
    <EconManual>true</EconManual>
    <EconPreWetActive>true</EconPreWetActive>
    <EconSpinnerSelectorPosition>9</EconSpinnerSelectorPosition>
    <EconRateSelectorPosition>10</EconRateSelectorPosition>
    <EconPloughActive>true</EconPloughActive>
  </EconData>
</ArrayOfEconData>