Vehicles
Endpoints for getting an account's vehicles
A logged in user can have multiple vehicles under their account (congrats on being rich!). This resource is primarily responsible for listing the vehicles and the basic details about them.
One potentially confusing part of Tesla's API is the switching use of the
id
and vehicle_id
of the car. The id
field is an identifier for the car on the owner-api endpoint. The vehicle_id
field is for identifying the car across different endpoints, such as the streaming or Autopark APIs.For the state and command APIs, you should be using the
id
field. If your JSON parser doesn't support large numbers (>32 bit), then you can use the id_s
field for a string version of the ID.Retrieve a list of your owned vehicles.
The list is limited to a maximum of 100 entries. Use the
page
GET parameter to iterate over the response page and use the response count
variable to determine if another request should be made.Field | Example | Description | Required | Default |
---|---|---|---|---|
page | 1 | The page number | no | 1 |
{
"response": [
{
"id": 12345678901234567,
"vehicle_id": 1234567890,
"vin": "5YJSA11111111111",
"display_name": "Nikola 2.0",
"color": null,
"tokens": ["abcdef1234567890", "1234567890abcdef"],
"state": "online",
"in_service": false,
"id_s": "12345678901234567",
"calendar_enabled": true,
"api_version": 7,
"backseat_token": null,
"backseat_token_updated_at": null
}
],
"count": 1
}
These resources are read-only and determine the state of the vehicle's various sub-systems.
Field | Example | Description |
---|---|---|
id | 12345678901234567 | The id of the car. (Not the vehicle_id !) |
{
"response": {
"id": 12345678901234567,
"vehicle_id": 1234567890,
"vin": "5YJSA11111111111",
"display_name": "Nikola 2.0",
"color": null,
"tokens": ["abcdef1234567890", "1234567890abcdef"],
"state": "online",
"in_service": false,
"id_s": "12345678901234567",
"calendar_enabled": true,
"api_version": 7,
"backseat_token": null,
"backseat_token_updated_at": null
}
}
Last modified 5h ago