Skip to content

Engine hours

API base path: /tracker/stats/engine_hours


Returns engine hours (time when engine is on) count in specified period.


name description type format
tracker_id Id of the tracker (aka "object_id"). Tracker must belong to authorized user and not be blocked. int 123456
from From time in yyyy-MM-dd HH:mm:ss format (in user's timezone). string date/time "2020-09-24 03:24:00"
to To time in yyyy-MM-dd HH:mm:ss format (in user's timezone). Specified date must be after "from" date. string date/time "2020-09-24 06:24:00"


curl -X POST '' \
    -H 'Content-Type: application/json' \ 
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "tracker_id": "123456", "from": "2020-09-24 03:24:00", "to": "2020-09-24 06:24:00"}'


    "success": true,
    "value": 42.0


  • 204 – Entity not found (if there is no tracker with such id belonging to authorized user).
  • 208 – Device blocked (if tracker exists but was blocked due to tariff restrictions or some other reason).
  • 211 – Requested time span is too big (if interval between "from" and "to" is too big (maximum value specified in API config)).
  • 214 – Requested operation or parameters are not supported by the device (if device does not have ignition input).
  • 219 – Not allowed for clones of the device (if specified tracker is a clone).

Last update: October 23, 2020