{
    "tenantId": "e0736b86-[....]-e0396846f1f8",
    "type": "EV",
    "manufacturer": "Tesla",
    "vin": "1ABC36600TL029015",
}

​
What you’ll need

  • Your API credentials and a Tenant or Collective ID
  • The vehicle’s identification number (VIN) and its manufacturer
  • A way to reach out to the vehicle’s owner for consent

​
Locating the VIN

Illustration detailing how to find the VIN

​
Let’s get started

1

Start the onboarding process

Create an Entity Onboarding Request, setting the to EV.
You’ll need to specify a supported and the vehicle’s as a unique device identifier.

​
type
enum<string>
required
​
manufacturer
string
required

List all available Entity manufacturers to learn about the available options.

​
vin
string
required

Lastly, you may need to include either a or to complete the request.

2

Check for required actions

In most cases, the onboarding request will have the Pending until a required is completed.

How an action should be completed, depends on its .

  • Actions of type Redirect (most common) contain a . You can redirect your user here or share this link directly with the vehicle’s owner to complete the action.
  • Actions of type Consent have to be completed through the vehicle manufacturer’s app or by responding to a notification. They also contain a for more information on how to complete the action.
Response (Body)
{
    "id": "3c90c3cc-[....]-8dd25736052a",
    "status": "Pending",
    "requestType": "Entity",
    "action": {
        "type": "Redirect",
        "redirectLink": "<string>"
    },
    "data": {
        ...
    }, ...
}
​
action
object
3

Track the onboarding status

Periodically poll the Onboarding API to check if the status of your request has updated to Succeeded. Once it’s complete, you’ll find the newly created Entity and its ID in the object.

You can reference the when using our Readings API, Commands API, and our Charge Sessions API.

{
   "id": "3c90c3cc-[....]-8dd25736052a",
   "status": "Succeeded",
   "data": {
       "entity": {
           "id": "3c90c3cc-[...]-8dd25736052a",
           ...
       },
   }, ...
}

​
Work with your newly created Entity

Tip: Take note of your Entity ID before you get started with our APIs.

Readings API

Observe the state of the vehicle.

Commands API

Send charging instructions.

Charge Sessions API

See when the vehicle charged.

{
    "tenantId": "e0736b86-[....]-e0396846f1f8",
    "type": "EV",
    "manufacturer": "Tesla",
    "vin": "1ABC36600TL029015",
}