Contact us Login LIVE 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 protected]",
                "[email protected]"
            ],
            "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 317 1622

Log in

Loading...

We use сookies to improve our website, products and related services, analyze site traffic, and serve targeted advertisements. If you continue to use our services, you consent to our use of сookies. Read more