Contact us Login VIEW DEMO FREE TRIAL

read(…)

Get service task info by it’s id.

parameters:

  • task_idint. task id

return:

{
    "success": true,
    "value": {
        "id": 725, // task id
        "vehicle_id": 222, // id of associated vehicle
        "status": "created", // task status
        "prediction": {
            "end_date": "2015-05-03 09:35:00", // predicted end date
            "wear_percentage": 40 // wear percentage
        },
        "description": "Service task",
        "comment": "",
        "cost": 100500.0,
        "completion": { // date and counter's values when the task was marked as done. Non-editable.
            "mileage": 31,
            "date": "2014-03-16 00:00:00",
            "engine_hours": 140
        },
        "conditions": { // task end conditions. at least one of fields (mileage or date) must be passed.
            "mileage": { // optional
                "limit": 100, // task limit in kilometers. task end mileage = start.mileage + this limit
                "notification_interval": 10 // notify about task in specified number of kilometers
            },
            "date": { // optional
                "end": "2015-05-08 09:35:00", // task end date
                "notification_interval": 3    // notify about task in specified number of days
            },
            "engine_hours": { // optional
                "limit": 100, // task limit in hours. task end engine hours = start.engine_hours + this limit
                "notification_interval": 10 // notify about task in specified number of hours
            },
        },
        "start": { 
            "mileage": 1230,              // initial odometer value. for tasks with mileage condition 
            "date": "2015-05-01 17:46:44", // task creation date. for tasks with date condition 
            "engine_hours": 50 // initial engine hours value. for tasks with engine hours condition 
        },
        "notifications": {
            "sms_phones": [ //array of phones in international format wo + sign
                "79221234567",
                "79227654321"
            ],
            "emails": [//array of email addresses
                "email@domain.tld",
                "email@mail.com"
            ],
            "push_enabled": true // enable/disable push notifications
        },
        "completion_date" : "2014-03-16 00:00:00" // deprecated. use completion.date instead 
    }
}

About task status property see above.

errors:

  • 201 (Not found in database) – does not exists one of tracker’s counters which required to determine status
  • 204 (Entity not found) – when vehicle or service task not found

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
Loading...