GET
/machines/{id}/engineHours
Engine Hours
Become a beta tester for MachineMonitoring resources.
GET /machines /{id} /engineHours
Engine Hours
The engine hours service returns the last reported number of hours that a machine's engine has recorded. Each response includes a timestamp for the report and the source of the report. For each returned engine hours report, the response will include a link to the machine's information.
 
Request URI
GET https://apicert.soa-proxy.deere.com/platform/machines/{id}/engineHours
Accept: application/vnd.deere.axiom.v3+xml OR application/vnd.deere.axiom.v3+json
 
Request Parameters
Parameter Type Example Description Default Required?
startDate dateTime 2015-02-03T9:00:00.000Z Start date & time. N/A No.
endDate dateTime 2015-02-03T10:42:24.282Z End date & time. N/A No.
lastKnown boolean true Returns the last known timestamps and distance. If true, then startDate and endDate are ignored. false No.
 
Response Details
Field Type Example Description
reading measurementAsDouble <valueAsDouble> 523.5166666666667 </valueAsDouble> The number of hours the engine has been running.
reportTime dateTime 2010-10-04T14:35:05.000Z Timestamp at which the report was created.
source string CI Device which collected the data.1
 
Sample Response [JSON]
GET https://apicert.soa-proxy.deere.com/platform/machines/5432/engineHours
200 OK
Content-Type: application/vnd.deere.axiom.v3+json;charset=UTF-8

{
   "links": [
      {
         "rel": "self",
         "uri": "https://apicert.soa-proxy.deere.com/platform/machines/4321/engineHours?lastKnown=false"
      },
      {
         "rel": "nextPage",
         "uri": "https://apicert.soa-proxy.deere.com/platform/machines/4321/engineHours;start=10;count=10?lastKnown=false"
      }
   ],
   "total": 2,
   "values": [
      {
         "reading": {
            "@type": "measurementAsDouble",
            "valueAsDouble": 1.1833333,
            "links": null,
            "unit": "Hours"
         },
         "reportTime": "2010-10-04T15:06:34.000Z",
         "source": "TM",
         "links": [
            {
               "rel": "machine",
               "uri": "https://apicert.soa-proxy.deere.com/platform/machines/4321"
            }
         ]
      },
      {
         "reading": {
            "@type": "measurementAsDouble",
            "valueAsDouble": 1.1833333,
            "links": null,
            "unit": "Hours"
         },
         "reportTime": "2010-10-04T15:04:33.000Z",
         "source": "TM",
         "links": [
            {
               "rel": "machine",
               "uri": "https://apicert.soa-proxy.deere.com/platform/machines/4321"
            }
         ]
      }
   ]
}
 
[1] Sources & Definitions
TM Meter readings were received from an MTG or UTG.
MIG Meter readings were received from an MIG (Machine Information Gateway).
CI Meter readings were received from a GTT (GlobalTracs Terminal).