State And Settings

Last updated 7 months ago
get
Data
https://owner-api.teslamotors.com
/api/1/vehicles/:id/data
All of the vehicle data.
Request
Response
Path Parameters
:id
required
integer
The vehicle {id} from the vehicle list
Headers
Authorization
required
string
Bearer {access_token} from authorization
200: OK
{
  "response": {
    "id": :id,
    "user_id": :user_id,
    "vehicle_id": :vehicle_id,
    "vin": ":vin",
    "display_name": ":name",
    "option_codes": "AD15,AF02,AH00,APF0,APH2,APPA,AU00,BCMB,BP00,BR00,BS00,BTX4,CC02,CDM0,CH05,COUS,CW02,DRLH,DSH7,DV4W,FG02,FR01,GLFR,HC00,HP00,IDBO,INBPB,IX01,LP01,LT3B,MDLX,ME02,MI02,PF00,PI01,PK00,PMBL,QLPB,RCX0,RENA,RFPX,S02B,SP00,SR04,ST02,SU01,TIC4,TM00,TP03,TR01,TRA1,TW01,UM01,USSB,UTAB,WT20,X001,X003,X007,X011,X014,X021,X025,X026,X028,X031,X037,X040,X042,YFFC,SC05",
    "color": null,
    "tokens": [
      ":token1",
      ":token2"
    ],
    "state": "online",
    "in_service": null,
    "id_s": ":ids",
    "calendar_enabled": true,
    "backseat_token": null,
    "backseat_token_updated_at": null,
    "gui_settings": {
      "gui_distance_units": "mi/hr",
      "gui_temperature_units": "F",
      "gui_charge_rate_units": "mi/hr",
      "gui_24_hour_time": false,
      "gui_range_display": "Rated",
      "timestamp": 1532986218050
    },
    "vehicle_state": {
      "api_version": 3,
      "autopark_state": "unavailable",
      "autopark_state_v2": "standby",
      "autopark_style": "dead_man",
      "calendar_supported": true,
      "car_version": "2018.21.9 75bdbc11",
      "center_display_state": 0,
      "df": 0,
      "dr": 0,
      "ft": 0,
      "homelink_nearby": false,
      "last_autopark_error": "no_error",
      "locked": true,
      "notifications_supported": true,
      "odometer": 14522.605889,
      "parsed_calendar_supported": true,
      "pf": 0,
      "pr": 0,
      "remote_start": false,
      "remote_start_supported": true,
      "rt": 0,
      "sun_roof_percent_open": null,
      "sun_roof_state": "unknown",
      "timestamp": 1532986223303,
      "valet_mode": false,
      "vehicle_name": ":name"
    },
    "climate_state": {
      "inside_temp": 27.0,
      "outside_temp": 24.0,
      "driver_temp_setting": 18.3,
      "passenger_temp_setting": 18.3,
      "left_temp_direction": -280,
      "right_temp_direction": -280,
      "is_front_defroster_on": false,
      "is_rear_defroster_on": false,
      "fan_status": 0,
      "is_climate_on": false,
      "min_avail_temp": 15.0,
      "max_avail_temp": 28.0,
      "seat_heater_left": false,
      "seat_heater_right": false,
      "seat_heater_rear_left": false,
      "seat_heater_rear_right": false,
      "seat_heater_rear_center": false,
      "seat_heater_rear_right_back": 0,
      "seat_heater_rear_left_back": 0,
      "battery_heater": false,
      "battery_heater_no_power": false,
      "steering_wheel_heater": false,
      "wiper_blade_heater": false,
      "side_mirror_heaters": false,
      "is_preconditioning": false,
      "smart_preconditioning": false,
      "is_auto_conditioning_on": false,
      "timestamp": 1532986223306
    },
    "charge_state": {
      "charging_state": "Complete",
      "fast_charger_type": "\u003cinvalid\u003e",
      "fast_charger_brand": "\u003cinvalid\u003e",
      "charge_limit_soc": 86,
      "charge_limit_soc_std": 90,
      "charge_limit_soc_min": 50,
      "charge_limit_soc_max": 100,
      "charge_to_max_range": false,
      "max_range_charge_counter": 0,
      "fast_charger_present": false,
      "battery_range": 212.26,
      "est_battery_range": 152.09,
      "ideal_battery_range": 271.83,
      "battery_level": 83,
      "usable_battery_level": 83,
      "charge_energy_added": 16.57,
      "charge_miles_added_rated": 51.0,
      "charge_miles_added_ideal": 65.5,
      "charger_voltage": 0,
      "charger_pilot_current": 6,
      "charger_actual_current": 0,
      "charger_power": 0,
      "time_to_full_charge": 0.0,
      "trip_charging": false,
      "charge_rate": 0.0,
      "charge_port_door_open": true,
      "conn_charge_cable": "SAE",
      "scheduled_charging_start_time": null,
      "scheduled_charging_pending": false,
      "user_charge_enable_request": null,
      "charge_enable_request": true,
      "charger_phases": null,
      "charge_port_latch": "Engaged",
      "charge_current_request": 6,
      "charge_current_request_max": 6,
      "managed_charging_active": false,
      "managed_charging_user_canceled": false,
      "managed_charging_start_time": null,
      "battery_heater_on": false,
      "not_enough_power_to_heat": false,
      "timestamp": 1532986223305
    },
    "drive_state": {
      "shift_state": null,
      "speed": null,
      "power": 0,
      "latitude": 40.459728,
      "longitude": -79.923447,
      "heading": 340,
      "gps_as_of": 1532986222,
      "native_location_supported": 1,
      "native_latitude": 40.459729,
      "native_longitude": -79.923444,
      "native_type": "wgs",
      "timestamp": 1532986223305
    },
    "vehicle_config": {
      "can_actuate_trunks": true,
      "car_special_type": "base",
      "car_type": "modelx",
      "charge_port_type": "US",
      "eu_vehicle": false,
      "exterior_color": "MetallicBlack",
      "has_ludicrous_mode": false,
      "motorized_charge_port": true,
      "perf_config": "P1",
      "plg": true,
      "rear_seat_heaters": 3,
      "rear_seat_type": 3,
      "rhd": false,
      "roof_color": "None",
      "seat_type": 0,
      "spoiler_type": "Passive",
      "sun_roof_installed": 0,
      "third_row_seats": "FuturisFoldFlat",
      "timestamp": 1532986223303,
      "trim_badging": "90d",
      "wheel_type": "AeroTurbine20"
    }
  }
}
get
Mobile Enabled
https://owner-api.teslamotors.com
/api/1/vehicles/:id/mobile_enabled
Whether mobile access is enabled.
Request
Response
Path Parameters
:id
required
integer
The vehicle {id} from the vehicle list response
Headers
Authorization
required
string
Bearer {access_token} from authentication
200: OK
Mobile enabled successful response..
{
  "response": true
}
get
Charge State
https://owner-api.teslamotors.com
/api/1/vehicles/:id/data_request/charge_state
Charge state information including battery limit, charge miles, charge voltage, charge phases, current, charge management, and battery heater status.
Request
Response
Path Parameters
:id
required
integer
The vehicle {id} from the vehicle list response
Headers
Authorization
required
string
Bearer {access_token} from authentication
200: OK
Charge state successful response.
{
  "response": {
    "charging_state": "Complete",
    "fast_charger_type": "\u003cinvalid\u003e",
    "fast_charger_brand": "\u003cinvalid\u003e",
    "charge_limit_soc": 86,
    "charge_limit_soc_std": 90,
    "charge_limit_soc_min": 50,
    "charge_limit_soc_max": 100,
    "charge_to_max_range": false,
    "max_range_charge_counter": 0,
    "fast_charger_present": false,
    "battery_range": 219.06,
    "est_battery_range": 157.1,
    "ideal_battery_range": 280.53,
    "battery_level": 86,
    "usable_battery_level": 86,
    "charge_energy_added": 18.77,
    "charge_miles_added_rated": 58.0,
    "charge_miles_added_ideal": 74.0,
    "charger_voltage": 0,
    "charger_pilot_current": 7,
    "charger_actual_current": 0,
    "charger_power": 0,
    "time_to_full_charge": 0.0,
    "trip_charging": false,
    "charge_rate": 0.0,
    "charge_port_door_open": true,
    "conn_charge_cable": "SAE",
    "scheduled_charging_start_time": null,
    "scheduled_charging_pending": false,
    "user_charge_enable_request": null,
    "charge_enable_request": true,
    "charger_phases": null,
    "charge_port_latch": "Engaged",
    "charge_current_request": 7,
    "charge_current_request_max": 7,
    "managed_charging_active": false,
    "managed_charging_user_canceled": false,
    "managed_charging_start_time": null,
    "battery_heater_on": false,
    "not_enough_power_to_heat": false,
    "timestamp": 1532915238524
  }
}
get
Climate State
https://owner-api.teslamotors.com
/api/1/vehicles/:id/data_request/climate_state
Climate settings including seats, vents battery, steering wheel, and preconditioning state.
Request
Response
Path Parameters
:id
required
integer
Vehicle {id} from vehicle list response
Headers
Authorization
required
string
Bearer {access_token} from authentication
200: OK
Climate state successful response.
{
  "response": {
    "inside_temp": null,
    "outside_temp": null,
    "driver_temp_setting": 18.3,
    "passenger_temp_setting": 18.3,
    "left_temp_direction": null,
    "right_temp_direction": null,
    "is_front_defroster_on": false,
    "is_rear_defroster_on": false,
    "fan_status": 0,
    "is_climate_on": false,
    "min_avail_temp": 15.0,
    "max_avail_temp": 28.0,
    "seat_heater_left": false,
    "seat_heater_right": false,
    "seat_heater_rear_left": false,
    "seat_heater_rear_right": false,
    "seat_heater_rear_center": false,
    "seat_heater_rear_right_back": 0,
    "seat_heater_rear_left_back": 0,
    "battery_heater": false,
    "battery_heater_no_power": null,
    "steering_wheel_heater": false,
    "wiper_blade_heater": false,
    "side_mirror_heaters": false,
    "is_preconditioning": false,
    "smart_preconditioning": false,
    "is_auto_conditioning_on": null,
    "timestamp": 1532926836621
  }
}
get
Drive State
https://owner-api.teslamotors.com
/api/1/vehicles/:id/data_request/drive_state
Drive state including latitude, longitude, and heading of the vehicle.
Request
Response
Path Parameters
:id
required
integer
Vehicle {id} from vehicle list response
Headers
Authorization
required
string
Bearer {access_token} from authentication
200: OK
Drive state successful response
{
  "response": {
    "shift_state": null,
    "speed": null,
    "power": 0,
    "latitude": 40.459728,
    "longitude": -79.923447,
    "heading": 340,
    "gps_as_of": 1532927048,
    "native_location_supported": 1,
    "native_latitude": 40.459729,
    "native_longitude": -79.923444,
    "native_type": "wgs",
    "timestamp": 1532927316568
  }
}
get
GUI Settings
https://owner-api.teslamotors.com
/api/1/vehicles/:id/data_request/gui_settings
Localization settings including distance units, temperature units, charge units, and clock hour style.
Request
Response
Path Parameters
:id
required
integer
Vehicle {id} from vehicle list response
Headers
Authorization
required
string
Bearer {access_token} from authentication
200: OK
GUI Settings successful response.
{
  "response": {
    "gui_distance_units": "mi/hr",
    "gui_temperature_units": "F",
    "gui_charge_rate_units": "mi/hr",
    "gui_24_hour_time": false,
    "gui_range_display": "Rated",
    "timestamp": 1532927561350
  }
}
Vehicles - Previous
List
Next - Vehicles
Commands
State And Settings

getData

getMobile Enabled

getCharge State

getClimate State

getDrive State

getGUI Settings

get
Data

get
Mobile Enabled

get
Charge State

get
Climate State

get
Drive State

get
GUI Settings
