INVERS solutions connected sharing vehicles header mobile

Vehicle Commands API

The Vehicle Commands API allows to actively communicate with vehicles by sending commands.

Authenticate API calls

Learn how to authenticate api calls and get started!

Quick Start: Get vehicle state

Follow instructions and get an access token.

In order to request the current vehicle state of a particular vehicle in your fleet make this call – be sure to insert your access token and the particular vehicle’s ID:

curl -X POST \
  'https://api.invers.com/vehicles/{vehicle_id}/commands/request-vehicle-state' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Content-Type: application/json' -d ''

If the request has been successful, a JSON object is returned along with HTTP status code 200. The response contains information about the current state of the vehicle. Depending on the vehicle and the telematics unit installed the extent of information may vary.

Here’s an example how the response might look like:

{
    "mileage_in_kilometers": {
        "timestamp": "2020-01-30T13:22:05.000Z",
        "value": 10000
    },
    "fuel_level_in_percent": {
        "timestamp": "2020-01-30T13:22:05.000Z",
        "value": 85
    },
    "remaining_range_in_kilometers": {
        "timestamp": "2020-01-30T13:22:05.000Z",
        "value": 35
    },
    "position": {
        "timestamp": "2020-01-30T13:22:05.000Z",
        "value": {
            "lat": 50.834,
            "lon": 8.0219
        }
    },
    "cellular_signal_quality": {
        "timestamp": "2020-01-30T13:22:05.000Z",
        "value": 4
    },
    "driving_enabled": {
        "timestamp": "2020-01-30T13:22:05.000Z",
        "value": true
    },
    "top_case_lock": {
        "timestamp": "2020-01-30T13:22:05.000Z",
        "value": "UNLOCKED"
    },
    "top_case_lid": {
        "timestamp": "2020-01-30T13:22:05.000Z",
        "value": "OPEN"
    },
    "center_stand_position": {
        "timestamp": "2020-01-30T13:22:05.000Z",
        "value": "EXTENDED"
    },
    "telematics_brand": "NIU"
}