Devices API

This is a private API endpoint that is essential for developers using the DIMO Network. It provides functional commands surrounding the user's device(s) and is secured by either the Developer JWT and Vehicle JWT.

Entity Types

Country

Countries are a list of DIMO-supported countries. The countries are listed with many country formats in the data response and are searchable by looking up their 3-letter ISO 3166-1 alpha-3 country code.

DCN

DCN stands for Device Canonical Name, a smart contract protocol that provides an unique and user-friendly naming system for Vehicle IDs. By approving and purchasing DCNs via DIMO Buddy, vehicles can be registered and associated with a name such as ferrari.dimo. This is similar to the Ethereum Name Service (ENS).

Document

Documents are the vehicle-related documents that one would store on DIMO, namely title, registration, insurance, and pictures of maintenance history.

Integration

Integrations are the types of connections that DIMO offers. The API type of integration indicates a software connection, while the Hardware type is self-explanatory. Each integration type offer a different level of points, this is related to the baseline issuance of $DIMO tokens rewarded to a connected vehicle. You can learn more about how points are calculated in DIP-2.

Vehicle

The Vehicle entity in the Devices API essentially refers to the object that has shared privileges with the authenticated user. An additional token exchange is needed to obtain a short-lived permission to access a vehicle's data.

User Device

User Device is essentially the device(s) that belongs to the authenticated user.