1. General

API calls format

Notation used in this doc:


Which means that you should use the following URL:


with named parameters:

  • parameter1
  • parameter2
  • parameter3 is optional

Parameters can be passed in HTTP POST (application/x-www-form-urlencoded) or GET requests (POST is highly recommended):


(hash is required for most API calls to identify user session)

Typical actions:

  • list – list all resource entities with id-s and minimum additional info
  • read – read one entity by id
  • update – update one entity by id
  • delete – delete one entity by id


Common errors (should be handled for all API calls): 1-100

Resource or action specific errors: 101-200

Request and response format

To execute resource/action() send http GET or POST request to http://${API_URL}/${RESOURCE}/${ACTION}/

Response is (almost) always application/json.

On errors response will be in form:

    "success": false,
    "status": {
        "code": 1, // error code
        "description": "Database error" // error description

See error codes.

For example to read all user’s trackers as a list – use and get response:

{"id":37708,"label":"Paul (Man truck)","group_id":105450,"source":{"id":41249,"device_id":"2559413951","model":"vt350_wp","blocked":false,"tariff_id":1294,"phone":null,"status_listing_id":null,"creation_date":"2015-02-28","tariff_end_date":"2018-11-24"},"clone":true},
{"id":37709,"label":"Ann (Volkswagen)","group_id":105448,"source":{"id":24580,"device_id":"2809489482","model":"vt10rc_wp","blocked":false,"tariff_id":1300,"phone":null,"status_listing_id":null,"creation_date":"2013-12-26","tariff_end_date":"2018-11-24"},"clone":true},
{"id":37712,"label":"Rahul (Kamaz)","group_id":105450,"source":{"id":38494,"device_id":"2778805978","model":"vt10_wp","blocked":false,"tariff_id":1294,"phone":null,"status_listing_id":null,"creation_date":"2014-12-16","tariff_end_date":"2018-11-24"},"clone":true},
{"id":37714,"label":"Michael (Mazda 6)","group_id":105449,"source":{"id":57965,"device_id":"865733024522229","model":"arnavi3","blocked":false,"tariff_id":1294,"phone":null,"status_listing_id":null,"creation_date":"2015-11-24","tariff_end_date":"2018-11-24"},"clone":true},
{"id":311852,"label":"Samatha (Ford Focus)","group_id":105448,"source":{"id":104930,"device_id":"357454070772460","model":"telfm1120_fw0114","blocked":false,"tariff_id":1297,"phone":null,"status_listing_id":null,"creation_date":"2016-11-08","tariff_end_date":"2018-11-24"},"clone":true}

Or error if hash is wrong:

    "success": false,
    "status": {
        "code": 4,
        "description": "User not found or session ended"

HTTP codes

If “success” is true, HTTP code is always 200 OK (unless otherwise stated).

If there is an error, HTTP code is 400 BAD REQUEST (may vary depending on error type).

Authorization and access levels

Unless otherwise noted, every API call requires a valid user session hash (A String containing 32 hexademical characters) as “hash” parameter (see example above).

Session hash can be obtained via user/auth(login, password, [dealer_id]) API call.

Example: (GET method is used for demonstration purposes only!)

Custom types

  • date/time – is a string containing date/time in “yyyy-MM-dd HH:mm:ss” format (in user’s timezone).
  • local_time – is a string containing local time in “HH:mm:ss” format.
  • location – is json object contains geographical coordinates
    "lat": 56.827, // latitude
    "lng": 60.594296 // longitude
  • locale – string in format “language[_country]”, where language is ISO 639 alpha-2 language code, and country is ISO 3166 alpha-2 country code, e.g. en_US or ru. User interface support only language codes: ‘ru’, ‘en’, ‘es’, ‘ar’, ‘de’, ‘pt’, ‘ro’ and ‘uk’.

If you have more questions please contact our support team


USA: +1 858 225 46 88

Mexico: +52 558 526 11 25

UK: +44 203 807 64 62

Russia: +7 495 128 35 56

Log in


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