read(..)

Get current assigned status of the tracker.

parameters:

name description type
tracker_id Id of the tracker (aka "object_id"). Tracker must belong to authorized user and not be blocked. Int

return:

{
  "success": true,
  "current_status": { //status object showing current status of tracker. May be null
    "id": 2,
    "label": "On duty", 
    "color": "FFFF99"
  },
  "last_change": { //object describing last change of the status. May be null
    "id": 11,
    "old_status_id": null, //previous status id. May be null.
    "new_status_id": 2, //Current status id. May be null.
    "location": { //Location and address at which status change occurred
      "lat": 11.0,
      "lng": 22.0,
      "address": "Jones st, 4"
    },
    "changed": "2015-11-22 02:02:02", //change date and time
    "origin": "supervisor" //origin - who changed the status ("employee" or "supervisor")
  }
}

errors:

  • 201 - Not found in database (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)
  • 219 - Not allowed for clones of the device (if specified tracker is a clone)
  • 236 - Feature unavailable due to tariff restrictions (if there is no trackers with "statuses" tariff feature available)

If you have more questions please contact our support team

Contacts

USA: +1 858 815 9045

Mexico: +52 334 1642158

UK: +44 808 1641499

Germany: +49 1573 5988250

Russia: +7 495 223 0427

Log in

Login

[clean-login]

CLOSE
Register

[clean-login-register]

CLOSE