Introduction

This document describes the **autoaid Connected Car REST API** where you can get information about the status of your fleet.

Basic Concepts

These are the basic objects that we use to structure the data:

  • Device: The OBD dongle hardware which is used to interface with the vehicle

  • Vehicle: The car in which the OBD dongle is installed

  • Trip: A defined time interval where the car was driving

  • Event: A measurement or status update generated by the dongle

Security

You must use **Bearer Authentication** with an API key to use the service. Please contact info@autoaid.de if you haven't received an API key.

Endpoint

The endpoint to access data from version v2 is:

  • https://api-production.autoaid.de/cc/v2.0

List Devices

This method returns a list of all devices that are visible to the API key user. The user should provide a timestamp that is used for filtering, so that only devices are returned which have sent new data after the specified time.


Request

GET
/devices
Accept-Language
(header)
string
Select the preferred language in which the server should return the results (defaults to en-US) Available values : *, en, de, en-US, de-DE'

deviceIds
(query)
string
Return devices witch are in a defined list, e.g. 861359033310655, 861359033310600, 861359033310622

isOnline
(query)
boolean
Return devices witch are currently online or offline.

isPluggedIn
(query)
boolean
Return devices witch are currently plugged into a vehicle or not.

fromTimestamp
(query)
string($date-time)
Return devices within time range.

toTimestamp
(query)
string($date-time)
Return devices within time range.

filterTimestamp
(query)
string($date-time)
Return results which are newer than this timestamp (with respect to modifyTimestamp).

maxResults
(query)
integer
How many results to return, default value: 500 (maximum 10,000).
curl -X GET -G \
'https://api-production.autoaid.de/cc/v2.0/devices' \
-d isOnline=true \
-d isPluggedIn=true \
-d deviceIds=861359033310655,861359033310600,861359033310622
-d fromTimestamp=2020-02-22T14:37:07.797Z \
-d toTimestamp=2020-02-22T14:37:07.797Z \
-d filterTimestamp=2020-02-22T14:37:07.797Z \
-d maxResults=100 \
-H 'Authorization: Bearer apiKey' \
-H 'Accept-Language: en'

Response 200: Request Successful

Returns the list of my devices.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.

{
    "devices": [
        {
            "id": 861359038274344,
            "manufacturer": "autoaid",
            "hardwareType": "dongle",
            "hardwareVersion": "C5",
            "firmwareVersion": "1 Aug 16 2019",
            "isOnline": true,
            "isPluggedIn": true,
            "vehicleId": "VINYV1ZW25UDK1332944",
            "tripId": "90f228de5c611c7148d5",
            "modifyTimestamp": "2020-02-03T13:58:46.775Z"
        }
    ],
    "modifyTimestamp": "2020-02-03T13:58:46.775Z"
}

Response 400: Bad Request

The server cannot or will not process the request due to an apparent client error (e.g., malformed request syntax).


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 429: Too Many Requests

The user has sent too many requests in a given amount of time.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 403: Forbidden

The user does not have the permission to receive this type of data.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 401: Unauthorized

The user did not provide a valid API key.


{
    "errorMessage": "Unauthorized."
}

Get Device

This method returns information about a single device identified by its IMEI.


Request

GET
/devices/{deviceId}
deviceId
(path)
integer($int64)
Required, IMEI of device.

Accept-Language
(header)
string
Select the preferred language in which the server should return the results (defaults to en-US). Available values : *, en, de, en-US, de-DE

filterTimestamp
(query)
string($date-time)
Return results which are newer than this timestamp (with respect to modifyTimestamp).
curl -X GET -G \
'https://api-production.autoaid.de/cc/v2.0/devices/861359038274344' \
-d filterTimestamp=2020-02-22T14:37:07.797 \
-H 'Authorization: Bearer apiKey' \
-H 'Accept-Language: en'

Response 200: Request Successful

Returns the data for the device.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.

{
    "id": 861359038274344,
    "manufacturer": "autoaid",
    "hardwareType": "dongle",
    "hardwareVersion": "C5",
    "firmwareVersion": "1 Aug 16 2019",
    "isOnline": true,
    "isPluggedIn": true,
    "vehicleId": "VINYV1ZW25UDK1332944",
    "tripId": "90f228de5c611c7148d5",
    "modifyTimestamp": "2020-02-03T13:58:46.775Z"
}

Response 400: Bad Request

The server cannot or will not process the request due to an apparent client error (e.g., malformed request syntax).


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 429: Too Many Requests

The user has sent too many requests in a given amount of time.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 403: Forbidden

The user does not have the permission to receive this type of data.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 401: Unauthorized

The user did not provide a valid API key.


{
    "errorMessage": "Unauthorized."
}

List Vehicles

This method returns a list of all vehicles that are visible to the API key user. The user should provide a timestamp that is used for filtering, so that only vehicles are returned which have new data after the specified time. Each vehicle object contains also a list of the last events for each event type which have been collected for the vehicle. This way you can easily access the last position or mileage without making a separate request to /events.


Request

GET
/vehicles
Accept-Language
(header)
string
Select the preferred language in which the server should return the results (defaults to en-US)'. Available values : *, en, de, en-US, de-DE

deviceId
(query)
integer($int64)
The identifier for the device, i.e. the IMEI.

maxResults
(query)
integer
How many results to return, default value: 500 (maximum 10,000).

fromTimestamp
(query)
string($date-time)
Return vehicles within time range.

toTimestamp
(query)
string($date-time)
Return vehicles within time range.

filterTimestamp
(query)
string($date-time)
Return results which are newer than this timestamp (with respect to modifyTimestamp).
curl -X GET -G \
'https://api-production.autoaid.de/cc/v2.0/vehicles' \
-d deviceId=861359033310655 \
-d maxResults=100 \
-d filterTimestamp=2020-02-22T14:37:07.797 \
-H 'Authorization: Bearer apiKey' \
-H 'Accept-Language: en'

Response 200: Request Successful

Returns the list of my vehicles.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.

{
    "vehicles": [
        {
            "id": "VINYV1ZW25UDK1332944",
            "vin": "YV1ZW25UDK1332944",
            "tecDocMakeId": 120,
            "tecDocModelId": 38603,
            "tecDocVehicleId": 0,
            "make": "VOLVO",
            "model": "V60 II (225)",
            "vehicle": "T5",
            "fuelType": "Petrol",
            "kba": "0588AHA",
            "licensePlate": "B-AA 896",
            "deviceId": 861359033310655,
            "tripId": "90f228de5c611c7148d5",
            "lastEvents": [
                {
                    "deviceId": 861359038274344,
                    "recordedTimestamp": "2019-11-28T18:51:20.815Z",
                    "eventType": "MILEAGE",
                    "dataType": "NUMBER",
                    "value": 35538,
                    "unit": "km",
                    "unitId": 111
                }
            ],
            "modifyTimestamp": "2019-11-28T18:51:20.815Z",
            "deleteTimestamp": null
        }
    ],
    "modifyTimestamp": "2019-11-28T18:51:20.815Z"
}

Response 400: Bad Request

The server cannot or will not process the request due to an apparent client error (e.g., malformed request syntax).


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 429: Too Many Requests

The user has sent too many requests in a given amount of time.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 403: Forbidden

The user does not have the permission to receive this type of data.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 401: Unauthorized

The user did not provide a valid API key.


{
    "errorMessage": "Unauthorized."
}

Get Vehicle

This method returns information about a single vehicle. It is identified by its VIN together with the prefix 'VIN' (e.g. VINWAUZZZ123456789) so that the id is 20 characters long. If the VIN is unknown, you can use the device's IMEI to reference the vehicle like this: IMEI_861359033499999.

The vehicle object contains also a list of the last events for each event type which have been collected for the vehicle. This way you can easily access the last position or mileage without making a separate request to /events.


Request

GET
/vehicles/{vehicleId}
vehicleId
(path)
string
Required - The identifier of the vehicle

Accept-Language
(header)
string
Select the preferred language in which the server should return the results (defaults to en-US)'. Available values : *, en, de, en-US, de-DE

deviceId
(query)
integer($int64)
The identifier for the device, i.e. the IMEI.

filterTimestamp
(query)
string($date-time)
Return results which are newer than this timestamp (with respect to modifyTimestamp).
curl -X GET -G \
'https://api-production.autoaid.de/cc/v2.0/vehicles/VINYV1ZW25UDK1332944' \
-d filterTimestamp=2020-02-22T14:37:07.797 \
-d deviceId=861359033310655 -H 'Authorization: Bearer apiKey' \
-H 'Accept-Language: en'

Response 200: Request Successful

Returns the data for the vehicle.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response

{
    "id": "VINYV1ZW25UDK1332944",
    "vin": "YV1ZW25UDK1332944",
    "tecDocMakeId": 120,
    "tecDocModelId": 38603,
    "tecDocVehicleId": 0,
    "make": "VOLVO",
    "model": "V60 II (225)",
    "vehicle": "T5",
    "fuelType": "Petrol",
    "kba": "0588AHA",
    "licensePlate": "B-AA 896",
    "deviceId": 861359033310655,
    "tripId": "90f228de5c611c7148d5",
    "lastEvents": [
        {
            "deviceId": 861359038274344,
            "recordedTimestamp": "2019-11-28T18:51:20.815Z",
            "eventType": "MILEAGE",
            "dataType": "NUMBER",
            "value": 35538,
            "unit": "km",
            "unitId": 111
        }
    ],
    "modifyTimestamp": "2019-11-28T18:51:20.815Z",
    "deleteTimestamp": null
}

Response 400: Bad Request

The server cannot or will not process the request due to an apparent client error (e.g., malformed request syntax).


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 429: Too Many Requests

The user has sent too many requests in a given amount of time.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 403: Forbidden

The user does not have the permission to receive this type of data.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 401: Unauthorized

The user did not provide a valid API key.


{
    "errorMessage": "Unauthorized."
}

Update Vehicle

Use this method to change settings on a vehicle. The settings object can be submitted via put request containing one or several of the following attributes:

  • vin
    Submit the VIN of a vehicle in case the VIN could not be detected.
  • numberPlate
    Submit the number plate of a vehicle.
  • alarmSystem
    Submit true in case of an additional alarm system.
  • deleteTimestamp
    Submit a timestamp to set the delete timestamp of a vehicle to indicate that the vehicle should not be displayed anymore. Use null to reset the delete timestamp attribute of a vehicle.


Request

PUT
/vehicles/{vehicleId}/settings
vehicleId
(path)
string
Required - The identifier of the vehicle

Accept-Language
(header)
string
Select the preferred language in which the server should return the results (defaults to en-US)'. Available values : *, en, de, en-US, de-DE

settings
(body)
object
{
    "settings": {
        "numberPlate": "B-AA 201",
        "vin": "YV1ZW25UDK1332944",
        "alarmSystem": false,
        "deleteTimestamp": null
    }
}
curl -X POST -G \
'https://api-production.autoaid.de/cc/v2.0/vehicles/VINYV1ZW25UDK1332944/settings' \
--data-raw '{ "numberPlate" : "B-AA 201" }' \
-H 'Authorization: Bearer apiKey' \
-H 'Accept-Language: en' \
-H 'Content-Type: application/json'

Response 200: Request Successful


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response

Response 400: Bad Request

The server cannot or will not process the request due to an apparent client error (e.g., malformed request syntax).


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 429: Too Many Requests

The user has sent too many requests in a given amount of time.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 403: Forbidden

The user does not have the permission to receive this type of data.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 401: Unauthorized

The user did not provide a valid API key.


{
    "errorMessage": "Unauthorized."
}

List Trips

Get a list of the trips for my account or for a specified vehicle or device.


Request

GET
/trips
Accept-Language
(header)
string
Select the preferred language in which the server should return the results (defaults to en-US)'. Available values : *, en, de, en-US, de-DE

deviceId
(query)
integer($int64)
The identifier for the device, i.e. the IMEI.

vehicleId
(query)
string
The identifier of the vehicle.

fromTimestamp
(query)
string($date-time)
Return trips within time range.

toTimestamp
(query)
string($date-time)
Return trips within time range.

maxResults
(query)
integer
How many results to return, default value: 500 (maximum 10,000).

filterTimestamp
(query)
string($date-time)
Return results which are newer than this timestamp (with respect to modifyTimestamp).
curl -X GET -G \
'https://api-production.autoaid.de/cc/v2.0/trips' \
-d deviceId=861359038274344 \
-d vehicleId=VINYV1ZW25UDK1332944 \
-d fromTimestamp=2020-02-22T00:00:00 \
-d toTimestamp=2020-02-23T00:00:00 \
-d maxResults=100 \
-d filterTimestamp=2020-02-22T14:37:07.797 \
-H 'Authorization: Bearer apiKey' \
-H 'Accept-Language: en'

Response 200: Request Successful

Returns a list with trips and basic data.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.

{
    "trips": [
        {
            "id": "30b80666a025b5eb41bx",
            "deviceId": 861359038274344,
            "vehicleId": "VINYV1ZW25UDK1332944",
            "tripStartAddress": {
                "id": "20e116de5c633c8148ff",
                "road": "Helmholtzstra\u00dfe",
                "houseNumber": "2-9",
                "suburb": "Charlottenburg",
                "locality": "Berlin",
                "state": "Berlin",
                "country": "Germany",
                "postcode": "10587",
                "lat": 52.520374,
                "lon": 13.32426
            },
            "tripEndAddress": {
                "id": "20e116de5c633c8148ff",
                "road": "Helmholtzstra\u00dfe",
                "houseNumber": "2-9",
                "suburb": "Charlottenburg",
                "locality": "Berlin",
                "state": "Berlin",
                "country": "Germany",
                "postcode": "10587",
                "lat": 52.520374,
                "lon": 13.32426
            },
            "distance": 60,
            "duration": 3600,
            "tripStartTimestamp": "2020-02-03T13:00:00.775Z",
            "tripEndTimestamp": "2020-02-03T14:00:00.775Z",
            "aggregations": [
                {
                    "eventType": "MILEAGE",
                    "dataType": "NUMBER",
                    "aggregationType": "START",
                    "value": 32100,
                    "unit_id": 111,
                    "unit": "km"
                },
                {
                    "eventType": "MILEAGE",
                    "dataType": "NUMBER",
                    "aggregationType": "END",
                    "value": 32160,
                    "unit_id": 111,
                    "unit": "km"
                },
                {
                    "eventType": "POSITION",
                    "dataType": "STRING",
                    "aggregationType": "POLYLINE",
                    "value": "oufn_BwdqnO_AaG`Ij@b]k@jFyY_AykCkL}m@e]gk@gc@q`@c[mPqf@aO}m@kHq{"
                }
            ],
            "deleteTimestamp": null,
            "modifyTimestamp": "2020-02-03T14:00:00.775Z"
        }
    ],
    "modifyTimestamp": "2020-02-03T14:00:00.775Z"
}

Response 400: Bad Request

The server cannot or will not process the request due to an apparent client error (e.g., malformed request syntax).


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 429: Too Many Requests

The user has sent too many requests in a given amount of time.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 403: Forbidden

The user does not have the permission to receive this type of data.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 401: Unauthorized

The user did not provide a valid API key.


{
    "errorMessage": "Unauthorized."
}

Get Trip

Get the data for a single trip.


Request

GET
/trip/{tripId}
tripId
(path)
string
Required, the identifier of the trip.

Accept-Language
(header)
string
Select the preferred language in which the server should return the results (defaults to en-US)'. Available values : *, en, de, en-US, de-DE

filterTimestamp
(query)
string($date-time)
Return results which are newer than this timestamp (with respect to modifyTimestamp).
curl -X GET -G \
'https://api-production.autoaid.de/cc/v2.0/trips/30b80666a025b5eb41bx' \
-d filterTimestamp=2020-02-22T14:37:07.797 \
-H 'Authorization: Bearer apiKey' \
-H 'Accept-Language: en'

Response 200: Request Successful

Returns the data for the trip.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.

{
    "id": "30b80666a025b5eb41bx",
    "deviceId": 861359038274344,
    "vehicleId": "VINYV1ZW25UDK1332944",
    "tripStartAddress": {
        "id": "20e116de5c633c8148ff",
        "road": "Helmholtzstra\u00dfe",
        "houseNumber": "2-9",
        "suburb": "Charlottenburg",
        "locality": "Berlin",
        "state": "Berlin",
        "country": "Germany",
        "postcode": "10587",
        "lat": 52.520374,
        "lon": 13.32426
    },
    "tripEndAddress": {
        "id": "20e116de5c633c8148ff",
        "road": "Helmholtzstra\u00dfe",
        "houseNumber": "2-9",
        "suburb": "Charlottenburg",
        "locality": "Berlin",
        "state": "Berlin",
        "country": "Germany",
        "postcode": "10587",
        "lat": 52.520374,
        "lon": 13.32426
    },
    "distance": 60,
    "duration": 3600,
    "tripStartTimestamp": "2020-02-03T13:00:00.775Z",
    "tripEndTimestamp": "2020-02-03T14:00:00.775Z",
    "aggregations": [
        {
            "eventType": "MILEAGE",
            "dataType": "NUMBER",
            "aggregationType": "START",
            "value": 32100,
            "unit_id": 111,
            "unit": "km"
        },
        {
            "eventType": "MILEAGE",
            "dataType": "NUMBER",
            "aggregationType": "END",
            "value": 32160,
            "unit_id": 111,
            "unit": "km"
        },
        {
            "eventType": "POSITION",
            "dataType": "STRING",
            "aggregationType": "POLYLINE",
            "value": "oufn_BwdqnO_AaG`Ij@b]k@jFyY_AykCkL}m@e]gk@gc@q`@c[mPqf@aO}m@kHq{"
        }
    ],
    "deleteTimestamp": null,
    "modifyTimestamp": "2020-02-03T14:00:00.775Z"
}

Response 400: Bad Request

The server cannot or will not process the request due to an apparent client error (e.g., malformed request syntax).


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 429: Too Many Requests

The user has sent too many requests in a given amount of time.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 403: Forbidden

The user does not have the permission to receive this type of data.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 401: Unauthorized

The user did not provide a valid API key.


{
    "errorMessage": "Unauthorized."
}

List Events

Get the list of events for a device, a vehicle or a trip. You should provide one of these ids together with fromTimestamp and toTimestamp, so that the number of events remains smaller than maxResults. You can also specify a list of eventTypes to filter, e.g. eventType=POSITION,MILEAGE.


Request

GET
/events
Accept-Language
(header)
string
Select the preferred language in which the server should return the results (defaults to en-US)'. Available values : *, en, de, en-US, de-DE

deviceId
(query)
integer($int64)
The identifier for the device, i.e. the IMEI.

vehicleId
(query)
string
The identifier of the vehicle.

tripId
(query)
string
The identifier of the trip.

eventType
(query)
string
Defines the type of events which should be returned. Available values: MILEAGE, POSITION, FUEL_LEVEL_PERCENT, FUEL_LEVEL

fromTimestamp
(query)
string($date-time)
Return events within time range.

toTimestamp
(query)
string($date-time)
Return events within time range.

maxResults
(query)
integer
How many results to return, default value: 500 (maximum 10,000).
curl -X GET -G \
'https://api-production.autoaid.de/cc/v2.0/events' \
-d deviceId=861359033310655 \
-d vehicleId=VINYV1ZW25UDK1332944 \
-d eventType=MILEAGE,POSITION,IS_IGNITION_ON \
-d maxResults=100 \
-H 'Authorization: Bearer apiKey' \
-H 'Accept-Language: en'

Response 200: Request Successful

Returns the list of matching events.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
[
    {
        "event_type": "POSITION",
        "data_type": "GEO",
        "value": "POINT(13.428973 52.515955)",
        "device_id": 861359033310655,
        "recorded_timestamp": "2019-07-10T09:20:01.999Z"
    },
    {
        "event_type": "MILEAGE",
        "data_type": "NUMBER",
        "unit": "km",
        "unit_id": 111,
        "value": 22141,
        "device_id": 861359033310655,
        "recorded_timestamp": "2019-07-10T09:20:01.999Z"
    },
    {
        "event_type": "IS_IGNITION_ON",
        "data_type": "BOOLEAN",
        "value": true,
        "device_id": 861359033310655,
        "recorded_timestamp": "2019-07-10T09:20:01.999Z"
    }
]

List Dtcs

Get a list of the current Diagnostic Trouble Codes (DTC).


Request

GET
/dtcs
Accept-Language
(header)
string
Select the preferred language in which the server should return the results (defaults to en-US)'. Available values : *, en, de, en-US, de-DE

deviceId
(query)
integer($int64)
The identifier for the device, i.e. the IMEI.

vehicleId
(query)
string
The identifier of the vehicle.

fromTimestamp
(query)
string($date-time)
Return dtc list within time range.

toTimestamp
(query)
string($date-time)
Return dtc list within time range.

maxResults
(query)
integer
How many results to return, default value: 500 (maximum 10,000).

filterTimestamp
(query)
string($date-time)
Return results which are newer than this timestamp (with respect to modifyTimestamp).
curl -X GET -G \
'https://api-production.autoaid.de/cc/v2.0/dtcs' \
-d deviceId=861359038274344 \
-d vehicleId=VINYV1ZW25UDK1332944 \
-d fromTimestamp=2020-02-22T00:00:00Z \
-d toTimestamp=2020-02-23T00:00:00Z \
-d filterTimestamp=2020-02-22T14:37:07.797Z \
-d maxResults=100 \
-H 'Authorization: Bearer apiKey' \
-H 'Accept-Language: en'

Response 200: Request Successful

Returns the list of current fault codes.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.

{
    "dtcs": [
        {
            "id": "ee7184fd3a71548cf773",
            "vehicleId": "VINYV1ZW25UDK1332944",
            "deviceId": 861359033310655,
            "ecuTypeId": 91,
            "ecuType": "Engine Control Module (ECM)",
            "code": "3DE3",
            "encoded": "3DE3",
            "encoding": "HEX",
            "label": "DC/DC BOOST MODE LOW VOLTAGE SIDE",
            "dtcType": "Permanent",
            "recordedTimestamp": "2020-09-02T16:49:18.805Z",
            "deleteTimestamp": null,
            "modifyTimestamp": "2020-09-02T16:49:18.864196Z"
        }
    ],
    "modifyTimestamp": "2020-09-02T16:49:18.864196Z"
}

Response 400: Bad Request

The server cannot or will not process the request due to an apparent client error (e.g., malformed request syntax).


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 429: Too Many Requests

The user has sent too many requests in a given amount of time.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 403: Forbidden

The user does not have the permission to receive this type of data.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 401: Unauthorized

The user did not provide a valid API key.


{
    "errorMessage": "Unauthorized."
}

List Aggregations

Aggregations contain the statistics of events such as min, max, average etc. The values are grouped and aggregated into "bins" of equal size depending on the selected time interval (DAY, MONTH, YEAR).
Use this method if you need to get monthly mileage reports for a vehicle or the total fuel consumption of your entire fleet.


Request

GET
/aggregations
Accept-Language
(header)
string
Select the preferred language in which the server should return the results (defaults to en-US)'. Available values : *, en, de, en-US, de-DE

vehicleId
(query)
string
The identifier of the vehicle or "ALL" to aggregate data for the entire fleet.

aggregation
(query)
string
Defines the type of the collected data which should be returned. Available values: DRIVEN_DISTANCE, TRIP_DURATION

aggregationType
(query)
string
Defines the type of the aggregation. Available values: MIN, MAX, AVG, SUM. Default: Return all aggregations.

bin
(query)
string
Defines how aggregations are grouped. Available values: VEHICLE, FLEET

binSize
(query)
string
Defines the time over which aggregation is performed. Available values: DAY, WEEK, MONTH, YEAR. Default: DAY

fromTimestamp
(query)
string($date-time)
Return values within time range.

toTimestamp
(query)
string($date-time)
Return values within time range.
curl -X GET -G \
'https://api-production.autoaid.de/cc/v2.0/aggregations' \
-d vehicleId=VINYV1ZW25UDK1332944 \
-d aggregation=DRIVEN_DISTANCE,TRIP_DURATION \
-d aggregationType=SUM,AGV,MIN,MAX \
-d binSize=DAY \
-d bin=VEHICLE \
-d fromTimestamp=2019-07-01T00:00:00 \
-d toTimestamp=2019-07-03T00:00:00 \
-H 'Authorization: Bearer apiKey' \
-H 'Accept-Language: en'

Response 200: Request Successful

Returns the list of matching aggregations.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
[
    {
        "vehicleId": "VINYV1ZW25UDK1332944",
        "eventType": "MILEAGE",
        "dataType": "NUMBER",
        "aggregationType": "DIFFERENCE",
        "value": 200.5,
        "unit": "km",
        "unitId": 111,
        "bin": "2019-07-01T00:00:00"
    },
    {
        "vehicleId": "VINYV1ZW25UDK1332944",
        "eventType": "MILEAGE",
        "dataType": "NUMBER",
        "aggregationType": "DIFFERENCE",
        "value": 70.3,
        "unit": "km",
        "unitId": 111,
        "bin": "2019-07-02T00:00:00"
    }
]

Response 400: Bad Request

The server cannot or will not process the request due to an apparent client error (e.g., malformed request syntax).


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 429: Too Many Requests

The user has sent too many requests in a given amount of time.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 403: Forbidden

The user does not have the permission to receive this type of data.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 401: Unauthorized

The user did not provide a valid API key.


{
    "errorMessage": "Unauthorized."
}

List Event Types

Get list of all supported event types and their names, e.g. FUEL_LEVEL, BATTERY_VOLTAGE


Request

GET
/eventTypes
Accept-Language
(header)
string
Select the preferred language in which the server should return the results (defaults to en-US)'. Available values : *, en, de, en-US, de-DE
curl -X GET -G \
'https://api-production.autoaid.de/cc/v2.0/eventTypes' \
-H 'Authorization: Bearer apiKey' \
-H 'Accept-Language: en'

Response 200: Request Successful

Returns the list of event types.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.

[
    {
        "eventType": "BATTERY_VOLTAGE",
        "dataType": "NUMBER",
        "unit": "V",
        "unitId": 40
    }
]

Response 400: Bad Request

The server cannot or will not process the request due to an apparent client error (e.g., malformed request syntax).


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 429: Too Many Requests

The user has sent too many requests in a given amount of time.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 403: Forbidden

The user does not have the permission to receive this type of data.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 401: Unauthorized

The user did not provide a valid API key.


{
    "errorMessage": "Unauthorized."
}

List Unit Types

Get List of all available unit types for parameter measurements, e.g. °C, V or km/h


Request

GET
/units
Accept-Language
(header)
string
Select the preferred language in which the server should return the results (defaults to en-US)'. Available values : *, en, de, en-US, de-DE
                        
curl -X GET \
  'https://api-production.autoaid.de/cc/v2.0/units' \
  -H 'Authorization: Bearer  apiKey' \
  -H 'Accept-Language: en_US' \
                        
                    

Response 200: Request Successful

Returns the list of units.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.

[
  {
    "id": 112,
    "unitType": "km/h"
  }
]

Response 400: Bad Request

The server cannot or will not process the request due to an apparent client error (e.g., malformed request syntax).


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 429: Too Many Requests

The user has sent too many requests in a given amount of time.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 403: Forbidden

The user does not have the permission to receive this type of data.


X-Rate-Limit
(header)
integer
The total number of allowed requests in the current period.
X-Rate-Limit-Remaining
(header)
integer
The number of remaining requests in the current period.
X-Response-Time
(header)
integer
The number of milliseconds that the server needed to generate the response.
{
    "errorMessage": "An error has occurred while processing the request."
}

Response 401: Unauthorized

The user did not provide a valid API key.


{
    "errorMessage": "Unauthorized."
}

Events

Events can be distinguished by their type. Each eventType is unique but differs in the dataType to support string, float, boolean values and object values for position events. Events with dataType NUMBER include the additional fields unit and unitId. The values for eventType,dataType,unitId and unit are defined for each event.

Dongle Specific Events

Event Type
Data Type
Unit
Unit ID
Interval
Trigger
Description
NUMBER
%
20
-
when changed
Percentage value that measures the amount of strong acceleration manoeuvres.
BOOLEAN
-
-
-
when changed
Indication if alarm system is available in car.
NUMBER
V
40
60
interval, later when changed
Battery voltage value.
NUMBER
V
40
60
After Trip
Battery voltage value.
NUMBER
V
40
60
After sleepmode
Battery voltage value.
STRING
-
-
-
trip start
Current firmware of the dongle.
NUMBER
%
20
-
when changed
Percentage value that measures the amount of strong braking manoeuvres.
NUMBER
%
20
-
when changed
Percentage value that measures the amount of strong cornering manoeuvres.
STRING
-
-
-
user input
User input cost centre
NUMBER
km
111
60
interval
Driven distance since last report.
NUMBER
%
20
-
when changed
Percentage value that measures the total of braking, cornering and acceleration scores.
NUMBER
m/s²
130
-
event
Very strong acceleration
NUMBER
m/s²
130
-
braking event
Very strong deceleration through braking.
NUMBER
m/s²
130
-
event
Very strong acceleration detected when turning left.
NUMBER
m/s²
130
-
event
Very strong acceleration detected when turning right.
STRING
-
-
-
trip start
Current firmware of the dongle.
NUMBER
m
110
60
interval or direction change
Current height in meters.
NUMBER
°
60
60
interval or direction change
Current course in degree.
NUMBER
10
60
interval or direction change
Accuracy of the gps positions.
NUMBER
10
60
interval
Current gnss satellites in view.
NUMBER
10
60
interval
Current gnss satellites in use.
NUMBER
km/h
121
60
interval or direction change
Current speed in kmh.
NUMBER
m/s²
130
-
event
Strong acceleration
NUMBER
10
-
when changed
Number of strong acceleration manoeuvres.
NUMBER
m/s²
130
-
event
Strong deceleration through braking
NUMBER
10
-
when changed
Number of strong braking manoeuvres.
NUMBER
10
-
when changed
Number of strong cornering manoeuvres.
NUMBER
m/s²
130
-
event
Strong acceleration detected when turning left.
NUMBER
m/s²
130
-
event
Strong acceleration detected when turning right.
STRING
-
-
-
SIM Card ICCID
STRING
-
-
-
trip start
Sim card imsi id.
BOOLEAN
-
-
-
when changed
Signal if dongle is in standby mode or leaving standby mode.
BOOLEAN
-
-
-
when changed
Signal if the dongle is plugged into the car.
BOOLEAN
-
-
-
when changed
Signal if vehicle is moving or not moving.
STRING
-
-
-
when changed
identifier of the base station to which the dongle is connecetd. format: MCC;MNC;LAC;CellId
STRING
-
-
-
when changed
identifier of the base station to which the dongle is connecetd. format: MCC;MNC;LAC;CellId
STRING
-
-
-
GEO
-
-
60
interval or direction change
Vehicle position from GPS.
NUMBER
m/s²
130
-
event
Acceleration measured while driving over a pothole.
STRING
-
-
-
Signal when dongle starts reboot and finished rebooting.
NUMBER
m/s²
130
-
event
Strong acceleration values that indicate a crash with a lot of damage.
STRING
-
-
-
gps fix
Time until modul got a gnss fix.
NUMBER
s
160
-
Duration of a trip in seconds
STRING
-
-
-
user input
User input of driver id.
STRING
-
-
-
user input
User input of vehicle number plate.
NUMBER
m/s²
130
-
event
Strong acceleration values that indicate a crash.

Vehicle Specific / OEM Data Events

Event Type
Data Type
Unit
Unit ID
Interval
Trigger
Description
NUMBER
%
20
60
interval
Average absolute engine load in the the last time interval.
NUMBER
1/min
241
60
interval
Average rpm in the the last time interval.
NUMBER
1/min
241
60
interval
Max rpm in the the last time interval.
NUMBER
1/min
241
60
interval
Min rpm in the the last time interval.
NUMBER
°C
30
60
interval
Ambient air temperature.
NUMBER
l
90
300
interval, later when changed
Average fuel consumption
STRING
-
-
-
when changed
Current battery state.
NUMBER
km
111
300
interval
Remaining range front brake pads
NUMBER
km
111
300
interval
Remaining range rear brake pads
NUMBER
1/min
241
60
interval
Average rpm in the the last time interval.
NUMBER
1/min
241
60
interval
Max rpm in the the last time interval.
NUMBER
1/min
241
60
interval
Min rpm in the the last time interval.
NUMBER
l
90
300
interval, later when changed
Current fuel consumption
NUMBER
km
111
-
interval, later once per trip
Distance since last inspection.
NUMBER
km
111
300
when changed
Distance since the MIL is on.
NUMBER
km
111
60
when changed
Distance since dtc cleared.
NUMBER
10
-
when changed
DTC count.
NUMBER
°C
30
60
interval
Engine coolant temperature from OBD.
NUMBER
1/min
241
60
interval
Warning because of engine on while not driving
NUMBER
%
20
60
interval
Average engine load in the the last time interval.
NUMBER
%
20
60
interval
Max engine load in the the last time interval.
NUMBER
%
20
60
interval
Min engine load in the the last time interval.
NUMBER
°C
30
60
interval, later when changed
Engine oil temperature.
NUMBER
1/min
241
60
interval
Average rpm in the the last time interval.
NUMBER
1/min
241
60
interval
Max rpm in the the last time interval.
NUMBER
1/min
241
60
interval
Min rpm in the the last time interval.
NUMBER
s
160
60
interval
Time since engine is on in seconds.
BOOLEAN
-
-
-
when changed
Signal if engine is turned on or off.
NUMBER
l
90
300
interval, later when changed
Fuel level.
NUMBER
%
20
60
interval, later when changed
Fuel level in percent.
NUMBER
l/h
191
60
interval, later when changed
Current fuel rate by the vehicle.
NUMBER
l/h
191
60
Max fuel rate in the the last time interval.
NUMBER
l/h
191
60
interval
Min fuel rate in the the last time interval.
NUMBER
km
111
60
interval, later when changed
STRING
-
-
-
STRING
-
-
300
interval, later when changed
Date of gernal inspection
NUMBER
%
20
60
interval
Green rpm score in the the last time interval.
NUMBER
min
163
60
interval, later when changed
NUMBER
%
20
60
interval, later when changed
STRING
-
-
300
interval, later when changed
Current charging status (loading/not loading).
NUMBER
10
60
interval
Number of charge cycles of the high voltage battery.
NUMBER
Ohm
180
60
interval
Internal resistance of the high voltage battery.
BOOLEAN
-
-
-
when changed
NUMBER
kWh
373
60
interval
Total capacity of the high voltage battery when new
NUMBER
Ah
200
60
interval
Current charge level of the high voltage battery in Ah
NUMBER
s
160
60
interval
Time remaining until the high voltage battery will be fully charged
NUMBER
%
20
300
interval, later when changed
Remaining distance for the electric vehicle.
NUMBER
kWh
373
60
interval
Current charge level of the high voltage battery in kWh
NUMBER
km
111
60
interval, later when changed
NUMBER
%
20
300
interval, later when changed
State of charge (SoC) of the high voltage battery for electric vehicles.
NUMBER
%
20
60
interval, later when changed
Hybrid vehicles remaining battery life.
STRING
-
-
60
interval, later when changed
State of battery.
NUMBER
°C
30
60
interval, later when changed
Temperature of hv battery
NUMBER
kWh
373
60
interval, later when changed
NUMBER
Ah
200
60
interval
Maximum charge level of the high voltage battery in Ah when full.
NUMBER
V
40
60
interval
Total voltage for all cells together
NUMBER
km
111
-
interval, later once per trip
Remaining distance until next inspection.
NUMBER
d
165
-
interval, later once per trip
Remaining time until next inspection.
BOOLEAN
-
-
-
when changed
Current state of the gps switch.
BOOLEAN
-
-
-
when changed
Signal if ignition is turned on or off.
BOOLEAN
-
-
-
when changed
Signal if MIL is on or off.
BOOLEAN
-
-
300
interval, later when changed
Current oil level status.
NUMBER
1/min
241
60
interval
Average rpm in the the last time interval.
NUMBER
1/min
241
60
interval
Max rpm in the the last time interval.
NUMBER
1/min
241
60
interval
Min rpm in the the last time interval.
NUMBER
km
111
-
interval, later once per trip
Max distance until inspection.
NUMBER
d
165
-
interval, later once per trip
Max time until inspection.
NUMBER
km
111
300
interval, later when changed
Odometer distance.
STRING
-
-
-
first trip
Calibration id of the ecu.
STRING
-
-
-
first trip
Calibration verification number of the ecu.
NUMBER
10
-
when changed
Amount of OBD error codes.
STRING
-
-
-
when changed
Static OBD2 error codes.
STRING
-
-
-
when changed
Sporadically OBD2 error codes.
NUMBER
l/h
191
60
interval, later when changed
Current fuel rate by the vehicle. Unit g/s
NUMBER
l/h
191
60
interval
Min fuel rate in the the last time interval. Unit g/s
NUMBER
1/min
241
300
interval
Speed of Engine
STRING
-
-
-
NUMBER
km
111
-
interval, later once per trip
Remaining distance until next oil change.
NUMBER
d
165
-
interval, later once per trip
Remaining time until next oil change.
NUMBER
mm
113
300
interval, later when changed
Current oil level.
NUMBER
%
20
300
interval
Quality of oil
STRING
-
-
300
interval, later when changed
Date of oil service
NUMBER
mm
113
300
interval, later once per trip
Oil level warning threshold.
STRING
-
-
-
when changed
Read DTC from ECU.
NUMBER
km
111
60
interval, later when changed
NUMBER
km
111
300
interval
Remaining range of Additive
STRING
-
-
300
interval, later when changed
Date of service
NUMBER
km
111
300
interval, later once per trip
Distance exceeded since last necessary service.
NUMBER
d
165
300
interval, later once per trip
Time exceeded since last necessary service.
NUMBER
%
20
60
interval
Average throttle position in the the last time interval.
NUMBER
%
20
60
interval
Max throttle position in the the last time interval.
NUMBER
%
20
60
interval
Min throttle position in the the last time interval.
NUMBER
d
165
-
interval, later once per trip
Time since last inspection.
NUMBER
bar
173
300
interval
Pressure of front left tyre
NUMBER
bar
173
300
interval
Pressure of front right tyre
STRING
-
-
300
interval
Status of front left tyre
STRING
-
-
300
interval
Status of front right tyre
STRING
-
-
300
interval
Status of rear left tyre
STRING
-
-
300
interval
Status of rear right tyre
NUMBER
bar
173
300
interval
Pressure of rear left tyre
NUMBER
bar
173
300
interval
Pressure of rear right tyre
STRING
-
-
300
interval
Status of tyre pressure
NUMBER
km/h
121
60
interval
Average vehicle speed in the the last time interval.
NUMBER
km/h
121
60
interval
Max vehicle speed in the the last time interval.
NUMBER
km/h
121
60
interval
Min vehicle speed in the the last time interval.
VIN
STRING
-
-
-
first trip
Vehicle identification number.
NUMBER
km/h
121
60
interval
Warning because high vehicle speed detected.
NUMBER
1/min
241
60
interval
Warning because of high RPM detected.
NUMBER
%
20
60
interval
Warning because high throttle position detected.

Schemas

Event

Base class or interface Event which holds the common properties recordedTimestamp, deviceId, eventType and dataType.


deviceId:
integer($int64)
The IMEI of the device.
recordedTimestamp:
string($date-time)
The timestamp when the event has been recorded.
dataType:
string
Type of value encoding (STRING, BOOLEAN, NUMBER, GEO).
eventType:
string
Indicates which event is encoded.

Device

A device object contains the basic properties of the OBD dongle.


id:
integer($int64)
The id of the device, i.e. the IMEI.
manufacturer:
string
The hardware manufacturer of the device, i.e. autoaid.
hardwareType:
string
The hardware type of the device.
hardwareVersion:
string
The hardware version of the device.
firmwareVersion:
string
The software version which is currently running on the device.
isOnline:
boolean
A flag indicating whether the device is currently sending data.
isPluggedIn:
boolean
A flag indicating whether the device is currently installed.
vehicleId:
string
The id of the vehicle in which the device has been installed.
tripId:
string
The id of the trip that is currently in progress.
modifyTimestamp:
string($date-time)
The timestamp, when the device status has changed.

{
    "id": 861359038274344,
    "manufacturer": "autoaid",
    "hardwareType": "dongle",
    "hardwareVersion": "C5",
    "firmwareVersion": "1 Aug 16 2019",
    "isOnline": true,
    "isPluggedIn": true,
    "vehicleId": "VINYV1ZW25UDK1332944",
    "tripId": "90f228de5c611c7148d5",
    "modifyTimestamp": "2020-02-03T13:58:46.775Z"
}

Vehicle

Vehicle object containing basic data like make or model together with a snapshot of the latest events grouped by eventType.


id:
string
The id of the vehicle (usually the VIN with the prefix 'VIN', otherwise the IMEI of the device with the prefix 'IMEI_').
vin:
string
The vehicle identification number (VIN) of the vehicle.
tecDocMakeId:
integer($int32)
The make id of the vehicle from the TecDoc database.
tecDocModelId:
integer($int32)
The model id of the vehicle from the TecDoc database.
tecDocVehicleId:
integer($int32)
The vehicle id from the TecDoc database if known (usually 0).
make:
string
The name of the vehicle manufacturer.
model:
string
The name of the vehicle model.
vehicle:
string
The detailed name of the vehicle containing engine specific data (usually empty).
fuelType:
string
The fuel type of the vehicle if it can be determined.
kba:
string
The number of German KBA that uniquely identifies the vehicle (usally empty).
licensePlate:
string
The license plate of the vehicle, if it has been configured.
deviceId:
integer($int64)
The IMEI of the device which is currently installed in the vehicle.
tripId:
string
The id of the current trip. This field is empty when the car is not driving.
lastEvents:
Event []
A snapshot of the latest events grouped by eventType.
modifyTimestamp:
string($date-time)
The timestamp, when the vehicle status has changed.
deleteTimestamp:
string($date-time)
The delete timestamp is used to mark the vehicle as deleted. The vehicle is marked as deleted if this timestamp is not null. The delete timestamp can be changed with update vehicle request.

{
    "id": "VINYV1ZW25UDK1332944",
    "vin": "YV1ZW25UDK1332944",
    "tecDocMakeId": 120,
    "tecDocModelId": 38603,
    "tecDocVehicleId": 0,
    "make": "VOLVO",
    "model": "V60 II (225)",
    "vehicle": "T5",
    "fuelType": "Petrol",
    "kba": "0588AHA",
    "licensePlate": "B-AA 896",
    "deviceId": 861359033310655,
    "tripId": "90f228de5c611c7148d5",
    "lastEvents": [
        {
            "deviceId": 861359038274344,
            "recordedTimestamp": "2019-11-28T18:51:20.815Z",
            "eventType": "MILEAGE",
            "dataType": "NUMBER",
            "value": 35538,
            "unit": "km",
            "unitId": 111
        }
    ],
    "modifyTimestamp": "2019-11-28T18:51:20.815Z",
    "deleteTimestamp": null
}

Trip

Trip object containing basic data duration, distance, address data of start and end position.


id:
string
Identifier of the trip.
vehicleId:
string
Vehicle identifier of the trip.
tripStartAddress:
Address
Address object with details to the start position of a trip.
tripEndAddress:
Address
Address object with details to the end position of a trip.
distance:
float
The driven distance of a trip in km.
duration:
integer($int32)
The time how long the trip was, calculated in seconds.
tripStartTimestamp:
string($date-time)
The timestamp when the trip has been started.
tripEndTimestamp:
string($date-time)
The timestamp when the trip has been stopped.
aggregations:
[] Aggregation
List of aggregated events.

deleteTimestamp:
string($date-time)
The timestamp, when the trip was marked as deleted.
modifyTimestamp:
string($date-time)
The timestamp, when the trip status has changed.
{
    "id": "30b80666a025b5eb41bx",
    "deviceId": 861359038274344,
    "vehicleId": "VINYV1ZW25UDK1332944",
    "tripStartAddress": {
        "id": "20e116de5c633c8148ff",
        "road": "Helmholtzstra\u00dfe",
        "houseNumber": "2-9",
        "suburb": "Charlottenburg",
        "locality": "Berlin",
        "state": "Berlin",
        "country": "Germany",
        "postcode": "10587",
        "lat": 52.520374,
        "lon": 13.32426
    },
    "tripEndAddress": {
        "id": "20e116de5c633c8148ff",
        "road": "Helmholtzstra\u00dfe",
        "houseNumber": "2-9",
        "suburb": "Charlottenburg",
        "locality": "Berlin",
        "state": "Berlin",
        "country": "Germany",
        "postcode": "10587",
        "lat": 52.520374,
        "lon": 13.32426
    },
    "distance": 60,
    "duration": 3600,
    "tripStartTimestamp": "2020-02-03T13:00:00.775Z",
    "tripEndTimestamp": "2020-02-03T14:00:00.775Z",
    "aggregations": [
        {
            "eventType": "MILEAGE",
            "dataType": "NUMBER",
            "aggregationType": "START",
            "value": 32100,
            "unit_id": 111,
            "unit": "km"
        },
        {
            "eventType": "MILEAGE",
            "dataType": "NUMBER",
            "aggregationType": "END",
            "value": 32160,
            "unit_id": 111,
            "unit": "km"
        },
        {
            "eventType": "POSITION",
            "dataType": "STRING",
            "aggregationType": "POLYLINE",
            "value": "oufn_BwdqnO_AaG`Ij@b]k@jFyY_AykCkL}m@e]gk@gc@q`@c[mPqf@aO}m@kHq{"
        }
    ],
    "deleteTimestamp": null,
    "modifyTimestamp": "2020-02-03T14:00:00.775Z"
}

Address

Address object containing related data to a geo position.


id:
string
Identifier of the address.
road:
string
Translated road related to the start or end position of a trip.
houseNumber:
string
Translated house number related to the start or end position of a trip.
suburb:
string
Translated suburb related to the start or end position of a trip.
locality:
string
Translated locality related to the start or end position of a trip.
state:
string
Translated state related to the start or end position of a trip.
country:
boolean
Translated country related to the start or end position of a trip.
postcode:
string
Translated postcode related to the start or end position of a trip.
lat:
number($float)
Latitude value of the start or end position of a trip.
lon:
number($float)
Longitude value of the start or end position of a trip.
{
    "id": "20e116de5c633c8148ff",
    "road": "Helmholtzstra\u00dfe",
    "houseNumber": "2-9",
    "suburb": "Charlottenburg",
    "locality": "Berlin",
    "state": "Berlin",
    "country": "Germany",
    "postcode": "10587",
    "lat": 52.520374,
    "lon": 13.32426
}

Aggregation

Aggregation object containing different statistics of events such as min, max, average etc. The values are grouped and aggregated into "bins" of equal size depending on the selected time interval (DAY, MONTH, YEAR).


vehicleId:
string
Identifier of the vehicle.
eventType:
string
Type of the aggregated event like MILEAGE, FUEL_LEVEL, POSITION
dataType:
string
Data type of the aggregated event.
aggregationType:
string
Available types are MIN, MAX, AVG, DIFFERENCE, START, END
value:
string
Aggregated value.
unitId:
integer
Id of the unit.
unit:
string
Unit of the value
bin:
string($date-time)
The timestamp on which the aggregations are grouped.
{
    "vehicleId": "VINYV1ZW25UDK1332944",
    "eventType": "MILEAGE",
    "dataType": "NUMBER",
    "aggregationType": "DIFFERENCE",
    "value": 200.5,
    "unit": "km",
    "unitId": 111,
    "bin": "2019-07-01T00:00:00"
}

DTC

Object containing basic data to a diagnostic trouble code (DTC).


id:
string
Identifier of the fault code.
vehicleId:
string
Vehicle identifier.
deviceId:
integer($int64)
Device identifier (IMEI).
ecuTypeId:
integer($int32)
Identifier of the Electronic Control Unit (ECU).
ecuType:
string
Translated name of the Electronic Control Unit (ECU) like Engine Control Unit.
code:
string
Diagnostic Trouble Code (DTC).
encoded
string
Encoded representation of the Diagnostic Trouble Code.
encoding:
string
Type of encoding. Possible values are HEX, DECIMAL, PCODE
label:
string
Translated fault code text.
dtcType:
string
Type of the fault code. Possible values are PERMANENT, SPORADIC, FREEZEFRAME
recordedTimestamp:
string($date-time)
The timestamp, when the fault code was captured.
{
    "id": "ee7184fd3a71548cf773",
    "vehicleId": "VINYV1ZW25UDK1332944",
    "deviceId": 861359033310655,
    "ecuTypeId": 91,
    "ecuType": "Engine Control Module (ECM)",
    "code": "3DE3",
    "encoded": "3DE3",
    "encoding": "HEX",
    "label": "DC/DC BOOST MODE LOW VOLTAGE SIDE",
    "dtcType": "Permanent",
    "recordedTimestamp": "2020-09-02T16:49:18.805Z",
    "deleteTimestamp": null,
    "modifyTimestamp": "2020-09-02T16:49:18.864196Z"
}

ABSOLUTE ENGINE LOAD AVERAGE

Average absolute engine load in the the last time interval.


eventType:
ABSOLUTE_ENGINE_LOAD_AVERAGE
dataType:
NUMBER
unit:
%
unitId:
20
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "ABSOLUTE_ENGINE_LOAD_AVERAGE",
    "dataType": "NUMBER",
    "unit": "%",
    "unitId": 20,
    "value": 38,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

ACCELERATION SCORE

Percentage value that measures the amount of strong acceleration manoeuvres.


eventType:
ACCELERATION_SCORE
dataType:
NUMBER
unit:
%
unitId:
20
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "ACCELERATION_SCORE",
    "dataType": "NUMBER",
    "unit": "%",
    "unitId": 20,
    "value": 86.3,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

AIR FUEL EQUIVALENCE RATIO AVERAGE

Average rpm in the the last time interval.


eventType:
AIR_FUEL_EQUIVALENCE_RATIO_AVERAGE
dataType:
NUMBER
unit:
1/min
unitId:
241
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "AIR_FUEL_EQUIVALENCE_RATIO_AVERAGE",
    "dataType": "NUMBER",
    "unit": "1/min",
    "unitId": 241,
    "value": 1620,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

AIR FUEL EQUIVALENCE RATIO MAX

Max rpm in the the last time interval.


eventType:
AIR_FUEL_EQUIVALENCE_RATIO_MAX
dataType:
NUMBER
unit:
1/min
unitId:
241
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "AIR_FUEL_EQUIVALENCE_RATIO_MAX",
    "dataType": "NUMBER",
    "unit": "1/min",
    "unitId": 241,
    "value": 2120,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

AIR FUEL EQUIVALENCE RATIO MIN

Min rpm in the the last time interval.


eventType:
AIR_FUEL_EQUIVALENCE_RATIO_MIN
dataType:
NUMBER
unit:
1/min
unitId:
241
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "AIR_FUEL_EQUIVALENCE_RATIO_MIN",
    "dataType": "NUMBER",
    "unit": "1/min",
    "unitId": 241,
    "value": 900,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

ALARM SYSTEM

Indication if alarm system is available in car.


eventType:
ALARM_SYSTEM
dataType:
BOOLEAN
value:
boolean
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "ALARM_SYSTEM",
    "dataType": "BOOLEAN",
    "value": true,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

AMBIENT AIR TEMPERATURE

Ambient air temperature.


eventType:
AMBIENT_AIR_TEMPERATURE
dataType:
NUMBER
unit:
°C
unitId:
30
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "AMBIENT_AIR_TEMPERATURE",
    "dataType": "NUMBER",
    "unit": "°C",
    "unitId": 30,
    "value": 18,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

AVERAGE FUEL CONSUMPTION

Average fuel consumption


eventType:
AVERAGE_FUEL_CONSUMPTION
dataType:
NUMBER
unit:
l
unitId:
90
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "AVERAGE_FUEL_CONSUMPTION",
    "dataType": "NUMBER",
    "unit": "l",
    "unitId": 90,
    "value": 7.5,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

BATTERY STATE

Current battery state.

The dongle monitors the voltage of the starter battery. The following values are available, depending on the current voltage:

  • Overvoltage (>= 15.2 V)
  • Loading (>= 13 V)
  • Warning (<= 11.3 V)
  • Very Low (<= 10 V)
  • Empty (<= 6 V)

eventType:
BATTERY_STATE
dataType:
STRING
value:
string
Loading
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "BATTERY_STATE",
    "dataType": "STRING",
    "value": "Loading",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

BATTERY VOLTAGE

Battery voltage value.


eventType:
BATTERY_VOLTAGE
dataType:
NUMBER
unit:
V
unitId:
40
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "BATTERY_VOLTAGE",
    "dataType": "NUMBER",
    "unit": "V",
    "unitId": 40,
    "value": 12.5,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

BATTERY VOLTAGE MAX

Battery voltage value.


eventType:
BATTERY_VOLTAGE_MAX
dataType:
NUMBER
unit:
V
unitId:
40
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "BATTERY_VOLTAGE_MAX",
    "dataType": "NUMBER",
    "unit": "V",
    "unitId": 40,
    "value": 12.5,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

BATTERY VOLTAGE MIN

Battery voltage value.


eventType:
BATTERY_VOLTAGE_MIN
dataType:
NUMBER
unit:
V
unitId:
40
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "BATTERY_VOLTAGE_MIN",
    "dataType": "NUMBER",
    "unit": "V",
    "unitId": 40,
    "value": 12.5,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

BLT FIRMWARE VERSION

Current firmware of the dongle.


eventType:
BLT_FIRMWARE_VERSION
dataType:
STRING
value:
string
22 Jul 2019
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "BLT_FIRMWARE_VERSION",
    "dataType": "STRING",
    "value": "22 Jul 2019",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

BRAKE PADS FRONT REMAINING RANGE

Remaining range front brake pads


eventType:
BRAKE_PADS_FRONT_REMAINING_RANGE
dataType:
NUMBER
unit:
km
unitId:
111
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "BRAKE_PADS_FRONT_REMAINING_RANGE",
    "dataType": "NUMBER",
    "unit": "km",
    "unitId": 111,
    "value": 1000,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

BRAKE PADS REAR REMAINING RANGE

Remaining range rear brake pads


eventType:
BRAKE_PADS_REAR_REMAINING_RANGE
dataType:
NUMBER
unit:
km
unitId:
111
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "BRAKE_PADS_REAR_REMAINING_RANGE",
    "dataType": "NUMBER",
    "unit": "km",
    "unitId": 111,
    "value": 1000,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

BRAKING SCORE

Percentage value that measures the amount of strong braking manoeuvres.


eventType:
BRAKING_SCORE
dataType:
NUMBER
unit:
%
unitId:
20
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "BRAKING_SCORE",
    "dataType": "NUMBER",
    "unit": "%",
    "unitId": 20,
    "value": 86.3,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

COMMANDED AIR FUEL EQUIVALENCE RATIO AVERAGE

Average rpm in the the last time interval.


eventType:
COMMANDED_AIR_FUEL_EQUIVALENCE_RATIO_AVERAGE
dataType:
NUMBER
unit:
1/min
unitId:
241
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "COMMANDED_AIR_FUEL_EQUIVALENCE_RATIO_AVERAGE",
    "dataType": "NUMBER",
    "unit": "1/min",
    "unitId": 241,
    "value": 1620,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

COMMANDED AIR FUEL EQUIVALENCE RATIO MAX

Max rpm in the the last time interval.


eventType:
COMMANDED_AIR_FUEL_EQUIVALENCE_RATIO_MAX
dataType:
NUMBER
unit:
1/min
unitId:
241
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "COMMANDED_AIR_FUEL_EQUIVALENCE_RATIO_MAX",
    "dataType": "NUMBER",
    "unit": "1/min",
    "unitId": 241,
    "value": 2120,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

COMMANDED AIR FUEL EQUIVALENCE RATIO MIN

Min rpm in the the last time interval.


eventType:
COMMANDED_AIR_FUEL_EQUIVALENCE_RATIO_MIN
dataType:
NUMBER
unit:
1/min
unitId:
241
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "COMMANDED_AIR_FUEL_EQUIVALENCE_RATIO_MIN",
    "dataType": "NUMBER",
    "unit": "1/min",
    "unitId": 241,
    "value": 900,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

CORNERING SCORE

Percentage value that measures the amount of strong cornering manoeuvres.


eventType:
CORNERING_SCORE
dataType:
NUMBER
unit:
%
unitId:
20
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "CORNERING_SCORE",
    "dataType": "NUMBER",
    "unit": "%",
    "unitId": 20,
    "value": 86.3,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

COST CONTRE

User input cost centre


eventType:
COST_CONTRE
dataType:
STRING
value:
string
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "COST_CONTRE",
    "dataType": "STRING",
    "value": "",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

CURRENT FUEL CONSUMPTION

Current fuel consumption


eventType:
CURRENT_FUEL_CONSUMPTION
dataType:
NUMBER
unit:
l
unitId:
90
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "CURRENT_FUEL_CONSUMPTION",
    "dataType": "NUMBER",
    "unit": "l",
    "unitId": 90,
    "value": 45.81,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

DISTANCE FROM INSPECTION

Distance since last inspection.


eventType:
DISTANCE_FROM_INSPECTION
dataType:
NUMBER
unit:
km
unitId:
111
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "DISTANCE_FROM_INSPECTION",
    "dataType": "NUMBER",
    "unit": "km",
    "unitId": 111,
    "value": 3800,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

DISTANCE MIL ON

Distance since the MIL is on.


eventType:
DISTANCE_MIL_ON
dataType:
NUMBER
unit:
km
unitId:
111
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "DISTANCE_MIL_ON",
    "dataType": "NUMBER",
    "unit": "km",
    "unitId": 111,
    "value": 0,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

DISTANCE SINCE CODES CLEARED

Distance since dtc cleared.


eventType:
DISTANCE_SINCE_CODES_CLEARED
dataType:
NUMBER
unit:
km
unitId:
111
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "DISTANCE_SINCE_CODES_CLEARED",
    "dataType": "NUMBER",
    "unit": "km",
    "unitId": 111,
    "value": 6510,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

DRIVEN DISTANCE

Driven distance since last report.


eventType:
DRIVEN_DISTANCE
dataType:
NUMBER
unit:
km
unitId:
111
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "DRIVEN_DISTANCE",
    "dataType": "NUMBER",
    "unit": "km",
    "unitId": 111,
    "value": 0.289,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

DRIVING SCORE

Percentage value that measures the total of braking, cornering and acceleration scores.


eventType:
DRIVING_SCORE
dataType:
NUMBER
unit:
%
unitId:
20
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "DRIVING_SCORE",
    "dataType": "NUMBER",
    "unit": "%",
    "unitId": 20,
    "value": 86.3,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

DTC COUNT

DTC count.


eventType:
DTC_COUNT
dataType:
NUMBER
unit:
unitId:
10
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "DTC_COUNT",
    "dataType": "NUMBER",
    "unit": "",
    "unitId": 10,
    "value": 3,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

ENGINE COOLANT TEMPERATURE

Engine coolant temperature from OBD.


eventType:
ENGINE_COOLANT_TEMPERATURE
dataType:
NUMBER
unit:
°C
unitId:
30
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "ENGINE_COOLANT_TEMPERATURE",
    "dataType": "NUMBER",
    "unit": "°C",
    "unitId": 30,
    "value": 90,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

ENGINE IDLE WARNING

Warning because of engine on while not driving


eventType:
ENGINE_IDLE_WARNING
dataType:
NUMBER
unit:
1/min
unitId:
241
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "ENGINE_IDLE_WARNING",
    "dataType": "NUMBER",
    "unit": "1/min",
    "unitId": 241,
    "value": 4600,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

ENGINE LOAD AVERAGE

Average engine load in the the last time interval.


eventType:
ENGINE_LOAD_AVERAGE
dataType:
NUMBER
unit:
%
unitId:
20
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "ENGINE_LOAD_AVERAGE",
    "dataType": "NUMBER",
    "unit": "%",
    "unitId": 20,
    "value": 38,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

ENGINE LOAD MAX

Max engine load in the the last time interval.


eventType:
ENGINE_LOAD_MAX
dataType:
NUMBER
unit:
%
unitId:
20
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "ENGINE_LOAD_MAX",
    "dataType": "NUMBER",
    "unit": "%",
    "unitId": 20,
    "value": 52,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

ENGINE LOAD MIN

Min engine load in the the last time interval.


eventType:
ENGINE_LOAD_MIN
dataType:
NUMBER
unit:
%
unitId:
20
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "ENGINE_LOAD_MIN",
    "dataType": "NUMBER",
    "unit": "%",
    "unitId": 20,
    "value": 10,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

ENGINE OIL TEMPERATURE

Engine oil temperature.


eventType:
ENGINE_OIL_TEMPERATURE
dataType:
NUMBER
unit:
°C
unitId:
30
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "ENGINE_OIL_TEMPERATURE",
    "dataType": "NUMBER",
    "unit": "°C",
    "unitId": 30,
    "value": 75,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

ENGINE RPM AVERAGE

Average rpm in the the last time interval.


eventType:
ENGINE_RPM_AVERAGE
dataType:
NUMBER
unit:
1/min
unitId:
241
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "ENGINE_RPM_AVERAGE",
    "dataType": "NUMBER",
    "unit": "1/min",
    "unitId": 241,
    "value": 1620,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

ENGINE RPM MAX

Max rpm in the the last time interval.


eventType:
ENGINE_RPM_MAX
dataType:
NUMBER
unit:
1/min
unitId:
241
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "ENGINE_RPM_MAX",
    "dataType": "NUMBER",
    "unit": "1/min",
    "unitId": 241,
    "value": 2120,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

ENGINE RPM MIN

Min rpm in the the last time interval.


eventType:
ENGINE_RPM_MIN
dataType:
NUMBER
unit:
1/min
unitId:
241
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "ENGINE_RPM_MIN",
    "dataType": "NUMBER",
    "unit": "1/min",
    "unitId": 241,
    "value": 900,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

ENGINE RUN TIME

Time since engine is on in seconds.


eventType:
ENGINE_RUN_TIME
dataType:
NUMBER
unit:
s
unitId:
160
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "ENGINE_RUN_TIME",
    "dataType": "NUMBER",
    "unit": "s",
    "unitId": 160,
    "value": 1040,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

ENGINE STATE

Signal if engine is turned on or off.


eventType:
ENGINE_STATE
dataType:
BOOLEAN
value:
boolean
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "ENGINE_STATE",
    "dataType": "BOOLEAN",
    "value": true,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

EXTREME ACCELERATION

Very strong acceleration


eventType:
EXTREME_ACCELERATION
dataType:
NUMBER
unit:
m/s²
unitId:
130
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "EXTREME_ACCELERATION",
    "dataType": "NUMBER",
    "unit": "m/s\u00b2",
    "unitId": 130,
    "value": 6.5,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

EXTREME BRAKING

Very strong deceleration through braking.


eventType:
EXTREME_BRAKING
dataType:
NUMBER
unit:
m/s²
unitId:
130
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "EXTREME_BRAKING",
    "dataType": "NUMBER",
    "unit": "m/s\u00b2",
    "unitId": 130,
    "value": 6.5,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

EXTREME LEFT CORNERING

Very strong acceleration detected when turning left.


eventType:
EXTREME_LEFT_CORNERING
dataType:
NUMBER
unit:
m/s²
unitId:
130
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "EXTREME_LEFT_CORNERING",
    "dataType": "NUMBER",
    "unit": "m/s\u00b2",
    "unitId": 130,
    "value": 5.3,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

EXTREME RIGHT CORNERING

Very strong acceleration detected when turning right.


eventType:
EXTREME_RIGHT_CORNERING
dataType:
NUMBER
unit:
m/s²
unitId:
130
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "EXTREME_RIGHT_CORNERING",
    "dataType": "NUMBER",
    "unit": "m/s\u00b2",
    "unitId": 130,
    "value": 5.3,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

FIRMWARE VERSION

Current firmware of the dongle.


eventType:
FIRMWARE_VERSION
dataType:
STRING
value:
string
22 Jul 2019
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "FIRMWARE_VERSION",
    "dataType": "STRING",
    "value": "22 Jul 2019",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

FUEL LEVEL

Fuel level.


eventType:
FUEL_LEVEL
dataType:
NUMBER
unit:
l
unitId:
90
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "FUEL_LEVEL",
    "dataType": "NUMBER",
    "unit": "l",
    "unitId": 90,
    "value": 13.5,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

FUEL LEVEL PERCENT

Fuel level in percent.


eventType:
FUEL_LEVEL_PERCENT
dataType:
NUMBER
unit:
%
unitId:
20
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "FUEL_LEVEL_PERCENT",
    "dataType": "NUMBER",
    "unit": "%",
    "unitId": 20,
    "value": 16,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

FUEL RATE AVERAGE

Current fuel rate by the vehicle.


eventType:
FUEL_RATE_AVERAGE
dataType:
NUMBER
unit:
l/h
unitId:
191
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "FUEL_RATE_AVERAGE",
    "dataType": "NUMBER",
    "unit": "l/h",
    "unitId": 191,
    "value": 30.5,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

FUEL RATE MAX

Max fuel rate in the the last time interval.


eventType:
FUEL_RATE_MAX
dataType:
NUMBER
unit:
l/h
unitId:
191
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "FUEL_RATE_MAX",
    "dataType": "NUMBER",
    "unit": "l/h",
    "unitId": 191,
    "value": 9.2,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

FUEL RATE MIN

Min fuel rate in the the last time interval.


eventType:
FUEL_RATE_MIN
dataType:
NUMBER
unit:
l/h
unitId:
191
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "FUEL_RATE_MIN",
    "dataType": "NUMBER",
    "unit": "l/h",
    "unitId": 191,
    "value": 4,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

FUEL REMAINING RANGE


eventType:
FUEL_REMAINING_RANGE
dataType:
NUMBER
unit:
km
unitId:
111
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "FUEL_REMAINING_RANGE",
    "dataType": "NUMBER",
    "unit": "km",
    "unitId": 111,
    "value": 0,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

FUEL TYPE


eventType:
FUEL_TYPE
dataType:
STRING
value:
string
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "FUEL_TYPE",
    "dataType": "STRING",
    "value": "",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

GENERAL INSPECTION DATE

Date of gernal inspection


eventType:
GENERAL_INSPECTION_DATE
dataType:
STRING
value:
string
11.2020
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "GENERAL_INSPECTION_DATE",
    "dataType": "STRING",
    "value": "11.2020",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

GPS ALTITUDE

Current height in meters.


eventType:
GPS_ALTITUDE
dataType:
NUMBER
unit:
m
unitId:
110
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "GPS_ALTITUDE",
    "dataType": "NUMBER",
    "unit": "m",
    "unitId": 110,
    "value": 44,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

GPS COURSE

Current course in degree.


eventType:
GPS_COURSE
dataType:
NUMBER
unit:
°
unitId:
60
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "GPS_COURSE",
    "dataType": "NUMBER",
    "unit": "\u00b0",
    "unitId": 60,
    "value": 316,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

GPS HDOP

Accuracy of the gps positions.


eventType:
GPS_HDOP
dataType:
NUMBER
unit:
unitId:
10
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "GPS_HDOP",
    "dataType": "NUMBER",
    "unit": "",
    "unitId": 10,
    "value": 1.1105,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

GPS SATELLITES IN USE

Current gnss satellites in view.


eventType:
GPS_SATELLITES_IN_USE
dataType:
NUMBER
unit:
unitId:
10
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "GPS_SATELLITES_IN_USE",
    "dataType": "NUMBER",
    "unit": "",
    "unitId": 10,
    "value": 9,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

GPS SATELLITES IN VIEW

Current gnss satellites in use.


eventType:
GPS_SATELLITES_IN_VIEW
dataType:
NUMBER
unit:
unitId:
10
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "GPS_SATELLITES_IN_VIEW",
    "dataType": "NUMBER",
    "unit": "",
    "unitId": 10,
    "value": 21,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

GPS SPEED

Current speed in kmh.


eventType:
GPS_SPEED
dataType:
NUMBER
unit:
km/h
unitId:
121
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "GPS_SPEED",
    "dataType": "NUMBER",
    "unit": "km/h",
    "unitId": 121,
    "value": 56,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

GREEN RPM PERCENTAGE

Green rpm score in the the last time interval.


eventType:
GREEN_RPM_PERCENTAGE
dataType:
NUMBER
unit:
%
unitId:
20
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "GREEN_RPM_PERCENTAGE",
    "dataType": "NUMBER",
    "unit": "%",
    "unitId": 20,
    "value": 90,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HARSH ACCELERATION

Strong acceleration


eventType:
HARSH_ACCELERATION
dataType:
NUMBER
unit:
m/s²
unitId:
130
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HARSH_ACCELERATION",
    "dataType": "NUMBER",
    "unit": "m/s\u00b2",
    "unitId": 130,
    "value": 6.5,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HARSH ACCELERATION COUNT

Number of strong acceleration manoeuvres.


eventType:
HARSH_ACCELERATION_COUNT
dataType:
NUMBER
unit:
unitId:
10
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HARSH_ACCELERATION_COUNT",
    "dataType": "NUMBER",
    "unit": "",
    "unitId": 10,
    "value": 25,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HARSH BRAKING

Strong deceleration through braking


eventType:
HARSH_BRAKING
dataType:
NUMBER
unit:
m/s²
unitId:
130
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HARSH_BRAKING",
    "dataType": "NUMBER",
    "unit": "m/s\u00b2",
    "unitId": 130,
    "value": 6.5,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HARSH BRAKING COUNT

Number of strong braking manoeuvres.


eventType:
HARSH_BRAKING_COUNT
dataType:
NUMBER
unit:
unitId:
10
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HARSH_BRAKING_COUNT",
    "dataType": "NUMBER",
    "unit": "",
    "unitId": 10,
    "value": 34,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HARSH CORNERING COUNT

Number of strong cornering manoeuvres.


eventType:
HARSH_CORNERING_COUNT
dataType:
NUMBER
unit:
unitId:
10
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HARSH_CORNERING_COUNT",
    "dataType": "NUMBER",
    "unit": "",
    "unitId": 10,
    "value": 43,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HARSH LEFT CORNERING

Strong acceleration detected when turning left.


eventType:
HARSH_LEFT_CORNERING
dataType:
NUMBER
unit:
m/s²
unitId:
130
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HARSH_LEFT_CORNERING",
    "dataType": "NUMBER",
    "unit": "m/s\u00b2",
    "unitId": 130,
    "value": 4.3,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HARSH RIGHT CORNERING

Strong acceleration detected when turning right.


eventType:
HARSH_RIGHT_CORNERING
dataType:
NUMBER
unit:
m/s²
unitId:
130
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HARSH_RIGHT_CORNERING",
    "dataType": "NUMBER",
    "unit": "m/s\u00b2",
    "unitId": 130,
    "value": 4.2,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HV BATTERY CHARGING CURRENT


eventType:
HV_BATTERY_CHARGING_CURRENT
dataType:
NUMBER
unit:
A
unitId:
50
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HV_BATTERY_CHARGING_CURRENT",
    "dataType": "NUMBER",
    "unit": "A",
    "unitId": 50,
    "value": 0,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HV BATTERY CHARGING DURATION


eventType:
HV_BATTERY_CHARGING_DURATION
dataType:
NUMBER
unit:
min
unitId:
163
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HV_BATTERY_CHARGING_DURATION",
    "dataType": "NUMBER",
    "unit": "min",
    "unitId": 163,
    "value": 0,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HV BATTERY CHARGING POWER


eventType:
HV_BATTERY_CHARGING_POWER
dataType:
NUMBER
unit:
%
unitId:
20
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HV_BATTERY_CHARGING_POWER",
    "dataType": "NUMBER",
    "unit": "%",
    "unitId": 20,
    "value": 0,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HV BATTERY CHARGING STATUS

Current charging status (loading/not loading).


eventType:
HV_BATTERY_CHARGING_STATUS
dataType:
STRING
value:
string
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HV_BATTERY_CHARGING_STATUS",
    "dataType": "STRING",
    "value": "",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HV BATTERY CYCLE COUNTER

Number of charge cycles of the high voltage battery.


eventType:
HV_BATTERY_CYCLE_COUNTER
dataType:
NUMBER
unit:
unitId:
10
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HV_BATTERY_CYCLE_COUNTER",
    "dataType": "NUMBER",
    "unit": "",
    "unitId": 10,
    "value": 235,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HV BATTERY INTERNAL RESISTANCE

Internal resistance of the high voltage battery.


eventType:
HV_BATTERY_INTERNAL_RESISTANCE
dataType:
NUMBER
unit:
Ohm
unitId:
180
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HV_BATTERY_INTERNAL_RESISTANCE",
    "dataType": "NUMBER",
    "unit": "Ohm",
    "unitId": 180,
    "value": 1.7,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HV BATTERY IS CHARGING


eventType:
HV_BATTERY_IS_CHARGING
dataType:
BOOLEAN
value:
boolean
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HV_BATTERY_IS_CHARGING",
    "dataType": "BOOLEAN",
    "value": true,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HV BATTERY NOMINAL ENERGY CAPACITY

Total capacity of the high voltage battery when new


eventType:
HV_BATTERY_NOMINAL_ENERGY_CAPACITY
dataType:
NUMBER
unit:
kWh
unitId:
373
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HV_BATTERY_NOMINAL_ENERGY_CAPACITY",
    "dataType": "NUMBER",
    "unit": "kWh",
    "unitId": 373,
    "value": 60,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HV BATTERY REMAINING CHARGE

Current charge level of the high voltage battery in Ah


eventType:
HV_BATTERY_REMAINING_CHARGE
dataType:
NUMBER
unit:
Ah
unitId:
200
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HV_BATTERY_REMAINING_CHARGE",
    "dataType": "NUMBER",
    "unit": "Ah",
    "unitId": 200,
    "value": 124.3,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HV BATTERY REMAINING CHARGING DURATION

Time remaining until the high voltage battery will be fully charged


eventType:
HV_BATTERY_REMAINING_CHARGING_DURATION
dataType:
NUMBER
unit:
s
unitId:
160
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HV_BATTERY_REMAINING_CHARGING_DURATION",
    "dataType": "NUMBER",
    "unit": "s",
    "unitId": 160,
    "value": 7638,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HV BATTERY REMAINING DISTANCE

Remaining distance for the electric vehicle.


eventType:
HV_BATTERY_REMAINING_DISTANCE
dataType:
NUMBER
unit:
%
unitId:
20
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HV_BATTERY_REMAINING_DISTANCE",
    "dataType": "NUMBER",
    "unit": "%",
    "unitId": 20,
    "value": 0,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HV BATTERY REMAINING ENERGY

Current charge level of the high voltage battery in kWh


eventType:
HV_BATTERY_REMAINING_ENERGY
dataType:
NUMBER
unit:
kWh
unitId:
373
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HV_BATTERY_REMAINING_ENERGY",
    "dataType": "NUMBER",
    "unit": "kWh",
    "unitId": 373,
    "value": 37.4,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HV BATTERY REMAINING RANGE


eventType:
HV_BATTERY_REMAINING_RANGE
dataType:
NUMBER
unit:
km
unitId:
111
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HV_BATTERY_REMAINING_RANGE",
    "dataType": "NUMBER",
    "unit": "km",
    "unitId": 111,
    "value": 0,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HV BATTERY SOC

State of charge (SoC) of the high voltage battery for electric vehicles.


eventType:
HV_BATTERY_SOC
dataType:
NUMBER
unit:
%
unitId:
20
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HV_BATTERY_SOC",
    "dataType": "NUMBER",
    "unit": "%",
    "unitId": 20,
    "value": 0,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HV BATTERY SOH

Hybrid vehicles remaining battery life.


eventType:
HV_BATTERY_SOH
dataType:
NUMBER
unit:
%
unitId:
20
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HV_BATTERY_SOH",
    "dataType": "NUMBER",
    "unit": "%",
    "unitId": 20,
    "value": 40,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HV BATTERY STATUS

State of battery.


eventType:
HV_BATTERY_STATUS
dataType:
STRING
value:
string
Being charged
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HV_BATTERY_STATUS",
    "dataType": "STRING",
    "value": "Being charged",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HV BATTERY TEMPERATURE

Temperature of hv battery


eventType:
HV_BATTERY_TEMPERATURE
dataType:
NUMBER
unit:
°C
unitId:
30
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HV_BATTERY_TEMPERATURE",
    "dataType": "NUMBER",
    "unit": "°C",
    "unitId": 30,
    "value": 11,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HV BATTERY TOTAL CAPACITY


eventType:
HV_BATTERY_TOTAL_CAPACITY
dataType:
NUMBER
unit:
kWh
unitId:
373
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HV_BATTERY_TOTAL_CAPACITY",
    "dataType": "NUMBER",
    "unit": "kWh",
    "unitId": 373,
    "value": 0,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HV BATTERY TOTAL MAXIMUM CHARGE

Maximum charge level of the high voltage battery in Ah when full.


eventType:
HV_BATTERY_TOTAL_MAXIMUM_CHARGE
dataType:
NUMBER
unit:
Ah
unitId:
200
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HV_BATTERY_TOTAL_MAXIMUM_CHARGE",
    "dataType": "NUMBER",
    "unit": "Ah",
    "unitId": 200,
    "value": 544.2,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

HV BATTERY VOLTAGE

Total voltage for all cells together


eventType:
HV_BATTERY_VOLTAGE
dataType:
NUMBER
unit:
V
unitId:
40
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "HV_BATTERY_VOLTAGE",
    "dataType": "NUMBER",
    "unit": "V",
    "unitId": 40,
    "value": 234,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

ICCID

SIM Card ICCID


eventType:
ICCID
dataType:
STRING
value:
string
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "ICCID",
    "dataType": "STRING",
    "value": "",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

IMSI

Sim card imsi id.


eventType:
IMSI
dataType:
STRING
value:
string
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "IMSI",
    "dataType": "STRING",
    "value": "",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

INSPECTION REMAINING DISTANCE

Remaining distance until next inspection.


eventType:
INSPECTION_REMAINING_DISTANCE
dataType:
NUMBER
unit:
km
unitId:
111
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "INSPECTION_REMAINING_DISTANCE",
    "dataType": "NUMBER",
    "unit": "km",
    "unitId": 111,
    "value": 25400,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

INSPECTION REMAINING TIME

Remaining time until next inspection.


eventType:
INSPECTION_REMAINING_TIME
dataType:
NUMBER
unit:
d
unitId:
165
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "INSPECTION_REMAINING_TIME",
    "dataType": "NUMBER",
    "unit": "d",
    "unitId": 165,
    "value": 285,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

IS DONGLE IN STANDBY

Signal if dongle is in standby mode or leaving standby mode.


eventType:
IS_DONGLE_IN_STANDBY
dataType:
BOOLEAN
value:
boolean
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "IS_DONGLE_IN_STANDBY",
    "dataType": "BOOLEAN",
    "value": true,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

IS DONGLE PLUGGED IN

Signal if the dongle is plugged into the car.


eventType:
IS_DONGLE_PLUGGED_IN
dataType:
BOOLEAN
value:
boolean
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "IS_DONGLE_PLUGGED_IN",
    "dataType": "BOOLEAN",
    "value": true,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

IS GPS SWITCH ON

Current state of the gps switch.


eventType:
IS_GPS_SWITCH_ON
dataType:
BOOLEAN
value:
boolean
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "IS_GPS_SWITCH_ON",
    "dataType": "BOOLEAN",
    "value": true,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

IS IGNITION ON

Signal if ignition is turned on or off.


eventType:
IS_IGNITION_ON
dataType:
BOOLEAN
value:
boolean
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "IS_IGNITION_ON",
    "dataType": "BOOLEAN",
    "value": true,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

IS MIL ON

Signal if MIL is on or off.


eventType:
IS_MIL_ON
dataType:
BOOLEAN
value:
boolean
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "IS_MIL_ON",
    "dataType": "BOOLEAN",
    "value": true,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

IS MOVING

Signal if vehicle is moving or not moving.


eventType:
IS_MOVING
dataType:
BOOLEAN
value:
boolean
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "IS_MOVING",
    "dataType": "BOOLEAN",
    "value": true,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

IS OIL LEVEL OK

Current oil level status.


eventType:
IS_OIL_LEVEL_OK
dataType:
BOOLEAN
value:
boolean
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "IS_OIL_LEVEL_OK",
    "dataType": "BOOLEAN",
    "value": true,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

MAF AIR FLOW AVERAGE

Average rpm in the the last time interval.


eventType:
MAF_AIR_FLOW_AVERAGE
dataType:
NUMBER
unit:
1/min
unitId:
241
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "MAF_AIR_FLOW_AVERAGE",
    "dataType": "NUMBER",
    "unit": "1/min",
    "unitId": 241,
    "value": 1620,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

MAF AIR FLOW MAX

Max rpm in the the last time interval.


eventType:
MAF_AIR_FLOW_MAX
dataType:
NUMBER
unit:
1/min
unitId:
241
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "MAF_AIR_FLOW_MAX",
    "dataType": "NUMBER",
    "unit": "1/min",
    "unitId": 241,
    "value": 2120,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

MAF AIR FLOW MIN

Min rpm in the the last time interval.


eventType:
MAF_AIR_FLOW_MIN
dataType:
NUMBER
unit:
1/min
unitId:
241
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "MAF_AIR_FLOW_MIN",
    "dataType": "NUMBER",
    "unit": "1/min",
    "unitId": 241,
    "value": 900,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

MAX DISTANCE UNTIL INSPECTION

Max distance until inspection.


eventType:
MAX_DISTANCE_UNTIL_INSPECTION
dataType:
NUMBER
unit:
km
unitId:
111
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "MAX_DISTANCE_UNTIL_INSPECTION",
    "dataType": "NUMBER",
    "unit": "km",
    "unitId": 111,
    "value": 30000,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

MAX TIME UNTIL INSPECTION

Max time until inspection.


eventType:
MAX_TIME_UNTIL_INSPECTION
dataType:
NUMBER
unit:
d
unitId:
165
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "MAX_TIME_UNTIL_INSPECTION",
    "dataType": "NUMBER",
    "unit": "d",
    "unitId": 165,
    "value": 365,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

MILEAGE

Odometer distance.


eventType:
MILEAGE
dataType:
NUMBER
unit:
km
unitId:
111
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "MILEAGE",
    "dataType": "NUMBER",
    "unit": "km",
    "unitId": 111,
    "value": 22141,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

NETWORK CELL INFO

identifier of the base station to which the dongle is connecetd. format: MCC;MNC;LAC;CellId


eventType:
NETWORK_CELL_INFO
dataType:
STRING
value:
string
262;01;5126;42198
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "NETWORK_CELL_INFO",
    "dataType": "STRING",
    "value": "262;01;5126;42198",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

NETWORK CELL INFO V2

identifier of the base station to which the dongle is connecetd. format: MCC;MNC;LAC;CellId


eventType:
NETWORK_CELL_INFO_V2
dataType:
STRING
value:
string
262;01;5126;42198
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "NETWORK_CELL_INFO_V2",
    "dataType": "STRING",
    "value": "262;01;5126;42198",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

OBD CALIBRATION ID

Calibration id of the ecu.


eventType:
OBD_CALIBRATION_ID
dataType:
STRING
value:
string
31491231AA
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "OBD_CALIBRATION_ID",
    "dataType": "STRING",
    "value": "31491231AA",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

OBD CALIBRATION VERIFICATION NUMBER

Calibration verification number of the ecu.


eventType:
OBD_CALIBRATION_VERIFICATION_NUMBER
dataType:
STRING
value:
string
C805A6B7
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "OBD_CALIBRATION_VERIFICATION_NUMBER",
    "dataType": "STRING",
    "value": "C805A6B7",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

OBD DTC COUNT

Amount of OBD error codes.


eventType:
OBD_DTC_COUNT
dataType:
NUMBER
unit:
unitId:
10
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "OBD_DTC_COUNT",
    "dataType": "NUMBER",
    "unit": "",
    "unitId": 10,
    "value": 2,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

OBD DTC PERMANENT

Static OBD2 error codes.


eventType:
OBD_DTC_PERMANENT
dataType:
STRING
value:
string
P1702
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "OBD_DTC_PERMANENT",
    "dataType": "STRING",
    "value": "P1702",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

OBD DTC SPORADIC

Sporadically OBD2 error codes.


eventType:
OBD_DTC_SPORADIC
dataType:
STRING
value:
string
U1602
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "OBD_DTC_SPORADIC",
    "dataType": "STRING",
    "value": "U1602",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

OBD FUEL RATE GS AVERAGE

Current fuel rate by the vehicle. Unit g/s


eventType:
OBD_FUEL_RATE_GS_AVERAGE
dataType:
NUMBER
unit:
l/h
unitId:
191
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "OBD_FUEL_RATE_GS_AVERAGE",
    "dataType": "NUMBER",
    "unit": "l/h",
    "unitId": 191,
    "value": 30.5,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

OBD FUEL RATE GS MIN

Min fuel rate in the the last time interval. Unit g/s


eventType:
OBD_FUEL_RATE_GS_MIN
dataType:
NUMBER
unit:
l/h
unitId:
191
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "OBD_FUEL_RATE_GS_MIN",
    "dataType": "NUMBER",
    "unit": "l/h",
    "unitId": 191,
    "value": 4,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

OBD PORT STATUS


eventType:
OBD_PORT_STATUS
dataType:
STRING
value:
string
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "OBD_PORT_STATUS",
    "dataType": "STRING",
    "value": "",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

OBD RPM

Speed of Engine


eventType:
OBD_RPM
dataType:
NUMBER
unit:
1/min
unitId:
241
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "OBD_RPM",
    "dataType": "NUMBER",
    "unit": "1/min",
    "unitId": 241,
    "value": 800,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

OBD TYPE


eventType:
OBD_TYPE
dataType:
STRING
value:
string
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "OBD_TYPE",
    "dataType": "STRING",
    "value": "",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

OIL CHANGE REMAINING DISTANCE

Remaining distance until next oil change.


eventType:
OIL_CHANGE_REMAINING_DISTANCE
dataType:
NUMBER
unit:
km
unitId:
111
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "OIL_CHANGE_REMAINING_DISTANCE",
    "dataType": "NUMBER",
    "unit": "km",
    "unitId": 111,
    "value": 26260,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

OIL CHANGE REMAINING TIME

Remaining time until next oil change.


eventType:
OIL_CHANGE_REMAINING_TIME
dataType:
NUMBER
unit:
d
unitId:
165
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "OIL_CHANGE_REMAINING_TIME",
    "dataType": "NUMBER",
    "unit": "d",
    "unitId": 165,
    "value": 31,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

OIL LEVEL

Current oil level.


eventType:
OIL_LEVEL
dataType:
NUMBER
unit:
mm
unitId:
113
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "OIL_LEVEL",
    "dataType": "NUMBER",
    "unit": "mm",
    "unitId": 113,
    "value": 61.82,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

OIL QUALITY

Quality of oil


eventType:
OIL_QUALITY
dataType:
NUMBER
unit:
%
unitId:
20
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "OIL_QUALITY",
    "dataType": "NUMBER",
    "unit": "%",
    "unitId": 20,
    "value": 100,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

OIL SERVICE DATE

Date of oil service


eventType:
OIL_SERVICE_DATE
dataType:
STRING
value:
string
11.2020
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "OIL_SERVICE_DATE",
    "dataType": "STRING",
    "value": "11.2020",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

OIL WARNING THRESHOLD

Oil level warning threshold.


eventType:
OIL_WARNING_THRESHOLD
dataType:
NUMBER
unit:
mm
unitId:
113
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "OIL_WARNING_THRESHOLD",
    "dataType": "NUMBER",
    "unit": "mm",
    "unitId": 113,
    "value": 48.5,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

POSITION

Vehicle position from GPS.


eventType:
POSITION
dataType:
GEO
value:
object
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "POSITION",
    "dataType": "GEO",
    "value": "POINT(13.428973 52.515955)",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

POTHOLE

Acceleration measured while driving over a pothole.


eventType:
POTHOLE
dataType:
NUMBER
unit:
m/s²
unitId:
130
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "POTHOLE",
    "dataType": "NUMBER",
    "unit": "m/s\u00b2",
    "unitId": 130,
    "value": 5.3,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

READ DTC

Read DTC from ECU.


eventType:
READ_DTC
dataType:
STRING
value:
string
91,25,3
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "READ_DTC",
    "dataType": "STRING",
    "value": "91",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

REBOOT RESPONSE

Signal when dongle starts reboot and finished rebooting.


eventType:
REBOOT_RESPONSE
dataType:
STRING
value:
string
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "REBOOT_RESPONSE",
    "dataType": "STRING",
    "value": "",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

REMAINING RANGE


eventType:
REMAINING_RANGE
dataType:
NUMBER
unit:
km
unitId:
111
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "REMAINING_RANGE",
    "dataType": "NUMBER",
    "unit": "km",
    "unitId": 111,
    "value": 0,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

REMAINING RANGE ADDITIVE

Remaining range of Additive


eventType:
REMAINING_RANGE_ADDITIVE
dataType:
NUMBER
unit:
km
unitId:
111
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "REMAINING_RANGE_ADDITIVE",
    "dataType": "NUMBER",
    "unit": "km",
    "unitId": 111,
    "value": 1000,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

SERVICE DATE

Date of service


eventType:
SERVICE_DATE
dataType:
STRING
value:
string
11.2020
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "SERVICE_DATE",
    "dataType": "STRING",
    "value": "11.2020",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

SERVICE EXCEEDED DISTANCE

Distance exceeded since last necessary service.


eventType:
SERVICE_EXCEEDED_DISTANCE
dataType:
NUMBER
unit:
km
unitId:
111
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "SERVICE_EXCEEDED_DISTANCE",
    "dataType": "NUMBER",
    "unit": "km",
    "unitId": 111,
    "value": 0,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

SERVICE EXCEEDED TIME

Time exceeded since last necessary service.


eventType:
SERVICE_EXCEEDED_TIME
dataType:
NUMBER
unit:
d
unitId:
165
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "SERVICE_EXCEEDED_TIME",
    "dataType": "NUMBER",
    "unit": "d",
    "unitId": 165,
    "value": 0,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

SEVERE CRASH

Strong acceleration values that indicate a crash with a lot of damage.


eventType:
SEVERE_CRASH
dataType:
NUMBER
unit:
m/s²
unitId:
130
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "SEVERE_CRASH",
    "dataType": "NUMBER",
    "unit": "m/s\u00b2",
    "unitId": 130,
    "value": 9.6,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

THROTTLE POSITION AVERAGE

Average throttle position in the the last time interval.


eventType:
THROTTLE_POSITION_AVERAGE
dataType:
NUMBER
unit:
%
unitId:
20
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "THROTTLE_POSITION_AVERAGE",
    "dataType": "NUMBER",
    "unit": "%",
    "unitId": 20,
    "value": 15,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

THROTTLE POSITION MAX

Max throttle position in the the last time interval.


eventType:
THROTTLE_POSITION_MAX
dataType:
NUMBER
unit:
%
unitId:
20
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "THROTTLE_POSITION_MAX",
    "dataType": "NUMBER",
    "unit": "%",
    "unitId": 20,
    "value": 40,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

THROTTLE POSITION MIN

Min throttle position in the the last time interval.


eventType:
THROTTLE_POSITION_MIN
dataType:
NUMBER
unit:
%
unitId:
20
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "THROTTLE_POSITION_MIN",
    "dataType": "NUMBER",
    "unit": "%",
    "unitId": 20,
    "value": 10,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

TIME FROM INSPECTION

Time since last inspection.


eventType:
TIME_FROM_INSPECTION
dataType:
NUMBER
unit:
d
unitId:
165
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "TIME_FROM_INSPECTION",
    "dataType": "NUMBER",
    "unit": "d",
    "unitId": 165,
    "value": 10,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

TIME TO FIRST FIX

Time until modul got a gnss fix.


eventType:
TIME_TO_FIRST_FIX
dataType:
STRING
value:
string
Coldstart 30537ms
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "TIME_TO_FIRST_FIX",
    "dataType": "STRING",
    "value": "Coldstart 30537ms",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

TRIP DURATION

Duration of a trip in seconds


eventType:
TRIP_DURATION
dataType:
NUMBER
unit:
s
unitId:
160
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "TRIP_DURATION",
    "dataType": "NUMBER",
    "unit": "s",
    "unitId": 160,
    "value": 3200,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

TYRE PRESSURE FRONT LEFT

Pressure of front left tyre


eventType:
TYRE_PRESSURE_FRONT_LEFT
dataType:
NUMBER
unit:
bar
unitId:
173
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "TYRE_PRESSURE_FRONT_LEFT",
    "dataType": "NUMBER",
    "unit": "bar",
    "unitId": 173,
    "value": 2,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

TYRE PRESSURE FRONT RIGHT

Pressure of front right tyre


eventType:
TYRE_PRESSURE_FRONT_RIGHT
dataType:
NUMBER
unit:
bar
unitId:
173
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "TYRE_PRESSURE_FRONT_RIGHT",
    "dataType": "NUMBER",
    "unit": "bar",
    "unitId": 173,
    "value": 2,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

TYRE PRESSURE OK FRONT LEFT

Status of front left tyre


eventType:
TYRE_PRESSURE_OK_FRONT_LEFT
dataType:
STRING
value:
string
ok
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "TYRE_PRESSURE_OK_FRONT_LEFT",
    "dataType": "STRING",
    "value": "ok",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

TYRE PRESSURE OK FRONT RIGHT

Status of front right tyre


eventType:
TYRE_PRESSURE_OK_FRONT_RIGHT
dataType:
STRING
value:
string
ok
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "TYRE_PRESSURE_OK_FRONT_RIGHT",
    "dataType": "STRING",
    "value": "ok",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

TYRE PRESSURE OK REAR LEFT

Status of rear left tyre


eventType:
TYRE_PRESSURE_OK_REAR_LEFT
dataType:
STRING
value:
string
ok
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "TYRE_PRESSURE_OK_REAR_LEFT",
    "dataType": "STRING",
    "value": "ok",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

TYRE PRESSURE OK REAR RIGHT

Status of rear right tyre


eventType:
TYRE_PRESSURE_OK_REAR_RIGHT
dataType:
STRING
value:
string
ok
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "TYRE_PRESSURE_OK_REAR_RIGHT",
    "dataType": "STRING",
    "value": "ok",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

TYRE PRESSURE REAR LEFT

Pressure of rear left tyre


eventType:
TYRE_PRESSURE_REAR_LEFT
dataType:
NUMBER
unit:
bar
unitId:
173
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "TYRE_PRESSURE_REAR_LEFT",
    "dataType": "NUMBER",
    "unit": "bar",
    "unitId": 173,
    "value": 2,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

TYRE PRESSURE REAR RIGHT

Pressure of rear right tyre


eventType:
TYRE_PRESSURE_REAR_RIGHT
dataType:
NUMBER
unit:
bar
unitId:
173
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "TYRE_PRESSURE_REAR_RIGHT",
    "dataType": "NUMBER",
    "unit": "bar",
    "unitId": 173,
    "value": 2,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

TYRE PRESSURE STATUS

Status of tyre pressure


eventType:
TYRE_PRESSURE_STATUS
dataType:
STRING
value:
string
ok
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "TYRE_PRESSURE_STATUS",
    "dataType": "STRING",
    "value": "ok",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

USER DRIVER ID

User input of driver id.


eventType:
USER_DRIVER_ID
dataType:
STRING
value:
string
15928166212
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "USER_DRIVER_ID",
    "dataType": "STRING",
    "value": "15928166212",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

USER NUMBER PLATE

User input of vehicle number plate.


eventType:
USER_NUMBER_PLATE
dataType:
STRING
value:
string
B-MB-100
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "USER_NUMBER_PLATE",
    "dataType": "STRING",
    "value": "B-MB-100",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

VEHICLE SPEED AVERAGE

Average vehicle speed in the the last time interval.


eventType:
VEHICLE_SPEED_AVERAGE
dataType:
NUMBER
unit:
km/h
unitId:
121
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "VEHICLE_SPEED_AVERAGE",
    "dataType": "NUMBER",
    "unit": "km/h",
    "unitId": 121,
    "value": 43,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

VEHICLE SPEED MAX

Max vehicle speed in the the last time interval.


eventType:
VEHICLE_SPEED_MAX
dataType:
NUMBER
unit:
km/h
unitId:
121
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "VEHICLE_SPEED_MAX",
    "dataType": "NUMBER",
    "unit": "km/h",
    "unitId": 121,
    "value": 59,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

VEHICLE SPEED MIN

Min vehicle speed in the the last time interval.


eventType:
VEHICLE_SPEED_MIN
dataType:
NUMBER
unit:
km/h
unitId:
121
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "VEHICLE_SPEED_MIN",
    "dataType": "NUMBER",
    "unit": "km/h",
    "unitId": 121,
    "value": 40,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

VIN

Vehicle identification number.


eventType:
VIN
dataType:
STRING
value:
string
TMBJB9NZ2A2012345
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "VIN",
    "dataType": "STRING",
    "value": "TMBJB9NZ2A2012345",
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

WARNING OVERSPEEDING

Warning because high vehicle speed detected.


eventType:
WARNING_OVERSPEEDING
dataType:
NUMBER
unit:
km/h
unitId:
121
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "WARNING_OVERSPEEDING",
    "dataType": "NUMBER",
    "unit": "km/h",
    "unitId": 121,
    "value": 190,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

WARNING RPM

Warning because of high RPM detected.


eventType:
WARNING_RPM
dataType:
NUMBER
unit:
1/min
unitId:
241
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "WARNING_RPM",
    "dataType": "NUMBER",
    "unit": "1/min",
    "unitId": 241,
    "value": 4600,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

WARNING THROTTLE POSITION

Warning because high throttle position detected.


eventType:
WARNING_THROTTLE_POSITION
dataType:
NUMBER
unit:
%
unitId:
20
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "WARNING_THROTTLE_POSITION",
    "dataType": "NUMBER",
    "unit": "%",
    "unitId": 20,
    "value": 94,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}

WEAK CRASH

Strong acceleration values that indicate a crash.


eventType:
WEAK_CRASH
dataType:
NUMBER
unit:
m/s²
unitId:
130
value:
float
deviceId:
integer($int64)
recordedTimestamp:
string($date-time)
{
    "eventType": "WEAK_CRASH",
    "dataType": "NUMBER",
    "unit": "m/s\u00b2",
    "unitId": 130,
    "value": 8.4,
    "deviceId": 861359038274344,
    "recordedTimestamp": "2019-07-10T09:20:01.999Z"
}