List less then or equal to limit of tracker events filtered by event types (events) between from date/time and to date/time sorted by time field.


  • trackers[int]. list of tracker’s ids
  • fromdate/time. start date/time for searching
  • todate/time. end date/time for searching. must be after “from” date
  • events[string] (optional, default: all). list of history types
  • limitint (optional, default: maxHistoryLimit). max count of entries in result
  • ascendingboolean (optional, default: true). Sort ascending by time when it is true and descending when false.

If events (event types) not passed then list all event types.

Available event types: alarmcontrol, battery_off, bracelet_close, bracelet_open, crash_alarm, detach, door_alarm, force_location_request, g_sensor, gps_lost, gps_recover, gsm_damp, harsh_driving, hood_alarm, idle_end, idle_start, ignition, info, input_change, inroute, outroute, inzone, outzone, lowpower, obd_plug_in, obd_unplug, obj_control, offline, online, parking, poweroff, poweron, security_control, sos, speedup, track_end, track_start, sensor_inrange, sensor_outrange, strap_bolt_cut, strap_bolt_ins, vibration_start, vibration_end, light_sensor_bright, light_sensor_dark

Default and max limit is 100 by default. (Note for StandAlone: this value configured by maxHistoryLimit config option).


    "success": true,
    "list": [ ${tracker_history_entry}, ... ], // list of zero or more JSON objects
    "limit_exceeded": false // boolean. false when listed all history entries satisfied to conditions 
                            // and true otherwise

where tracker_history_entry described in History entries


  • 211 – Requested time span is too big (time span between from and to is more than maxReportTimeSpan days)
  • 212 – Requested limit is too big (limit is more than maxHistoryLimit)

If you have more questions please contact our support team

Contact Us

USA: +1 858 815 9045

Mexico: +52 334 1642158

UK: +44 808 1641499

France: +33 644 605141

Germany: +49 157359 88250

Russia: +7 495 317 1622

Log in