Tracker events¶

Contains list method to get tracker's events.

API actions¶

API path: /history/tracker/.

list¶

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

Described this API call usage details in our guide.

Parameters¶

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

Available event types can be obtained by /history/type/list action.

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

Example¶

curl -X POST 'https://api.navixy.com/v2/history/tracker/list' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "trackers": [131312, 123985], "from": "2020-12-10 16:44:00", "to": "2020-12-22 16:44:00"}'

Response¶

{
    "success": true,
    "list": [{
         "id": 1,
         "type": "tracker",
         "is_read": false,
         "message": "Alarm",
         "time": "2020-01-01 00:00:00",
         "event": "offline",
         "tracker_id": 2,
         "rule_id": 3,
         "track_id": 4,
         "location":{ 
             "lat": 50.0,
             "lng": 60.0,
             "precision": 50
         },
         "address": "address",
         "extra": {
             "task_id": null ,
             "parent_task_id": null,
             "counter_id": null,
             "service_task_id": null,
             "checkin_id": null,
             "place_ids": null,
             "last_known_location": false,
             "tracker_label": "Tracker label",
             "emergency": false,
             "employee_id": 4563
         }
    }],
    "limit_exceeded": false
}

• list - list of zero or more history_entry` objects which described in Tracker history entry.
• limit_exceeded - boolean. false when listed all history entries satisfied with conditions and true otherwise.

Errors¶

• 211 – Requested time span is too big - time span between from and to is more than report.maxTimeSpan days.
• 212 – Requested limit is too big - limit is more than history.maxLimit.
• 217 – List contains nonexistent entities – if one of the specified trackers does not exist or is blocked.