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
  • event[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, driver_changed, 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)
  • 217 – List contains nonexistent entities – if one of the specified trackers does not exist or is blocked

If you have more questions please contact our support team


USA: +1 858 815 9045

Mexico: +52 334 1642158

UK: +44 808 1641499

Germany: +49 1573 5988250

Russia: +7 495 223 0427

Log in