Tesla Motors · Schema

Tesla Vehicle

A Tesla electric vehicle in the owner's account, including identification, state, and configuration.

AutomobilesElectric VehiclesCarsSmart VehiclesIoTFortune 1000

Properties

Name Type Description
id integer Unique numeric vehicle ID
vehicle_id integer Internal Tesla vehicle ID
vin string Vehicle Identification Number (17 characters)
display_name string User-assigned display name for the vehicle
option_codes string Comma-separated list of option codes for the vehicle configuration
color string Vehicle color code
state string Current connectivity state of the vehicle
in_service boolean Whether the vehicle is currently in service mode
user_id integer Owner's user ID
tokens array Authentication tokens for the vehicle
id_s string String representation of the vehicle ID
calendar_enabled boolean Whether calendar integration is enabled
api_version integer API version supported by the vehicle
backseat_token string Backseat token for child controls
View JSON Schema on GitHub

JSON Schema

tesla-motors-vehicle-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/tesla-motors/main/json-schema/tesla-motors-vehicle-schema.json",
  "title": "Tesla Vehicle",
  "description": "A Tesla electric vehicle in the owner's account, including identification, state, and configuration.",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Unique numeric vehicle ID"
    },
    "vehicle_id": {
      "type": "integer",
      "description": "Internal Tesla vehicle ID"
    },
    "vin": {
      "type": "string",
      "description": "Vehicle Identification Number (17 characters)"
    },
    "display_name": {
      "type": "string",
      "description": "User-assigned display name for the vehicle"
    },
    "option_codes": {
      "type": "string",
      "description": "Comma-separated list of option codes for the vehicle configuration"
    },
    "color": {
      "type": "string",
      "nullable": true,
      "description": "Vehicle color code"
    },
    "state": {
      "type": "string",
      "enum": ["online", "asleep", "offline"],
      "description": "Current connectivity state of the vehicle"
    },
    "in_service": {
      "type": "boolean",
      "description": "Whether the vehicle is currently in service mode"
    },
    "user_id": {
      "type": "integer",
      "description": "Owner's user ID"
    },
    "tokens": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Authentication tokens for the vehicle"
    },
    "id_s": {
      "type": "string",
      "description": "String representation of the vehicle ID"
    },
    "calendar_enabled": {
      "type": "boolean",
      "description": "Whether calendar integration is enabled"
    },
    "api_version": {
      "type": "integer",
      "description": "API version supported by the vehicle"
    },
    "backseat_token": {
      "type": "string",
      "nullable": true,
      "description": "Backseat token for child controls"
    }
  },
  "required": ["id", "vin", "state"]
}