Get all task belonging to user with optional filtering.


  • statusesstring[]. (optional. default all) list of task statuses, e.g. [“unassigned”,”failed”]
  • trackersarray of int. (optional) ids of the trackers to which task is assigned
  • fromstring. (optional) show tasks which are actual AFTER this date, e.g. “2014-07-01 00:00:00”
  • tostring. (optional) show tasks which are actual BEFORE this date, e.g. “2014-07-01 00:00:00”
  • filterstring. (optional) filter for task label and description
    If trackers, filter, from or to is not passed or null then appropriate condition not used to filter results.


    "success": true,
    "list": [ <task>, ... ]

Full JSON returned to the task/list

   "id": 111, //task id
   "user_id": 3, //user id (office). Unchangeable parameter.
   "tracker_id": 22, //tracker ID. Indicator ID by which the implementation of this task will be controlled.
   "location": { //area (circle geofence), entering and leaving of geofence will be controlled
       "lat": 56.5, //latitude
       "lng": 60.5, //longitude
       "address": "Schulhof 2, Wien, Austria", //area address
       "radius": 150 //radius in meters
    "label": "Name", //task name, length 1-200 characters
    "description": "Description example", //task description, length 0-1024 characters
    "creation_date": "2014-01-02 03:04:05", //date of creation of a task, unchangeable field
    "from": "2014-02-03 04:05:06", //start date of the interval - when the specified location has to be visited (in the user's time zone)
    "to": "2014-03-04 05:06:07"//end date of the interval - when the specified location has to be visited (in the user's time zone)
    "external_id": "01234567", //Text field for tracking of communication of the task with certain external systems (for example, number of the order). Is for reference only.
    "status": "assigned", //Current status of a task, can have "unassigned" value (unassigned to any executor), "assigned", "done", "failed", "delayed", "arrived"(arrived to geofence but haven't done the task)
    "status_change_date": "2014-01-02 03:04:05", //date of the last change of the status of a task
    "max_delay": 5, //the maximum time delay of the execution of the task, in minutes
    "min_stay_duration": 0, //the minimum stay time in the area of the task in which the task has to be done, in minutes
    "arrival_date": "2014-01-02 03:04:05", //date and time of arrival to the area of ​​the task, can be null, if the executor has not visited it yet
    "stay_duration": 10, //number of seconds spent inside task zone
    "origin": "manual", //the way of creation of a task, can be "manual", "scheduled" or "imported" (from excel)
     "type": "task" //reserved


general types only

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