curl --request GET \
--url https://api.tessie.com/{vin}/state \
--header 'Authorization: Bearer <token>'{
"id": 1492931520123456,
"vin": "5YJXCAE43LF123456",
"id_s": "1492931520123456",
"color": "string",
"state": "online",
"user_id": 1311857,
"in_service": true,
"vehicle_id": 1349238573,
"access_type": "OWNER",
"api_version": 34,
"drive_state": {
"power": 0,
"speed": "string",
"heading": 194,
"latitude": 40.7484,
"gps_as_of": 1643590638,
"longitude": 73.9857,
"timestamp": 1643590652755,
"native_type": "wgs",
"shift_state": "P",
"native_latitude": 40.7484,
"native_longitude": 73.9857,
"native_location_supported": 1,
"active_route_destination": "Empire State Building",
"active_route_energy_at_arrival": 81,
"active_route_latitude": -1.123456,
"active_route_longitude": 1.123456,
"active_route_miles_to_arrival": 4.12,
"active_route_minutes_to_arrival": 5.43,
"active_route_traffic_minutes_delay": 0
},
"charge_state": {
"timestamp": 1643590652755,
"charge_amps": 12,
"charge_rate": 0,
"battery_level": 89,
"battery_range": 269.01,
"charger_power": 0,
"trip_charging": true,
"charger_phases": "string",
"charging_state": "Complete",
"charger_voltage": 0,
"charge_limit_soc": 90,
"battery_heater_on": true,
"charge_port_color": "Off",
"charge_port_latch": "Engaged",
"conn_charge_cable": "SAE",
"est_battery_range": 223.25,
"fast_charger_type": "MCSingleWireCAN",
"fast_charger_brand": "<invalid>",
"charge_energy_added": 4.64,
"charge_to_max_range": true,
"ideal_battery_range": 999,
"time_to_full_charge": 0,
"charge_limit_soc_max": 100,
"charge_limit_soc_min": 50,
"charge_limit_soc_std": 90,
"fast_charger_present": true,
"usable_battery_level": 89,
"charge_enable_request": true,
"charge_port_door_open": true,
"charger_pilot_current": 12,
"preconditioning_times": "weekdays",
"charge_current_request": 12,
"charger_actual_current": 0,
"minutes_to_full_charge": 0,
"managed_charging_active": true,
"off_peak_charging_times": "all_week",
"off_peak_hours_end_time": 375,
"preconditioning_enabled": true,
"scheduled_charging_mode": "Off",
"charge_miles_added_ideal": 4641,
"charge_miles_added_rated": 14.5,
"max_range_charge_counter": 0,
"not_enough_power_to_heat": true,
"scheduled_departure_time": 1643578200,
"off_peak_charging_enabled": true,
"charge_current_request_max": 12,
"scheduled_charging_pending": true,
"user_charge_enable_request": "string",
"managed_charging_start_time": "string",
"charge_port_cold_weather_mode": "string",
"scheduled_charging_start_time": "string",
"managed_charging_user_canceled": true,
"scheduled_departure_time_minutes": 810,
"scheduled_charging_start_time_app": 817,
"supercharger_session_trip_planner": true,
"pack_current": -0.7,
"pack_voltage": 419.79,
"module_temp_min": 25.5,
"module_temp_max": 26,
"energy_remaining": 51.26,
"lifetime_energy_used": 5224.713
},
"display_name": "Seneca",
"gui_settings": {
"timestamp": 1643590652755,
"gui_24_hour_time": true,
"show_range_units": true,
"gui_range_display": "Rated",
"gui_distance_units": "mi/hr",
"gui_charge_rate_units": "kW",
"gui_temperature_units": "F"
},
"option_codes": "AD15MDL3PBSBRENABT37ID3WRF3GS3PBDRLHDV2WW39BAPF0COUSBC3BCH07PC30FC3PFG31GLFRHL31HM31IL31LTPBMR31FM3BRS3HSA3PSTCPSC04SU3CT3CATW00TM00UT3PWR00AU3PAPH3AF00ZCSTMI00CDM0",
"climate_state": {
"timestamp": 1643590652755,
"fan_status": 0,
"inside_temp": 24.3,
"defrost_mode": 0,
"outside_temp": 17.5,
"is_climate_on": true,
"battery_heater": true,
"bioweapon_mode": true,
"max_avail_temp": 28,
"min_avail_temp": 15,
"seat_heater_left": 0,
"hvac_auto_request": "On",
"seat_heater_right": 0,
"is_preconditioning": true,
"wiper_blade_heater": true,
"climate_keeper_mode": "off",
"driver_temp_setting": 22.8,
"left_temp_direction": 0,
"side_mirror_heaters": true,
"is_rear_defroster_on": true,
"right_temp_direction": 0,
"is_front_defroster_on": true,
"seat_heater_rear_left": 0,
"steering_wheel_heater": true,
"passenger_temp_setting": 22.8,
"seat_heater_rear_right": 0,
"battery_heater_no_power": true,
"is_auto_conditioning_on": true,
"seat_heater_rear_center": 0,
"cabin_overheat_protection": "On",
"seat_heater_third_row_left": 0,
"seat_heater_third_row_right": 0,
"remote_heater_control_enabled": true,
"allow_cabin_overheat_protection": true,
"supports_fan_only_cabin_overheat_protection": true
},
"vehicle_state": {
"df": 0,
"dr": 0,
"ft": 0,
"pf": 0,
"pr": 0,
"rt": 0,
"locked": true,
"odometer": 14096.485641,
"fd_window": 0,
"fp_window": 0,
"rd_window": 0,
"rp_window": 0,
"timestamp": 1643590652755,
"santa_mode": 0,
"valet_mode": true,
"api_version": 34,
"car_version": "2022.4 fae2af490933",
"media_state": {
"remote_control_enabled": true
},
"sentry_mode": true,
"remote_start": true,
"vehicle_name": "Seneca",
"dashcam_state": "Unavailable",
"autopark_style": "standard",
"homelink_nearby": true,
"is_user_present": true,
"software_update": {
"status": "available",
"version": "2022.4",
"install_perc": 1,
"download_perc": 0,
"expected_duration_sec": 2700
},
"speed_limit_mode": {
"active": true,
"pin_code_set": true,
"max_limit_mph": 90,
"min_limit_mph": 50,
"current_limit_mph": 84
},
"tpms_pressure_fl": "string",
"tpms_pressure_fr": "string",
"tpms_pressure_rl": "string",
"tpms_pressure_rr": "string",
"autopark_state_v2": "standby",
"calendar_supported": true,
"last_autopark_error": "no_error",
"center_display_state": 0,
"remote_start_enabled": true,
"homelink_device_count": 0,
"sentry_mode_available": true,
"remote_start_supported": true,
"smart_summon_available": true,
"notifications_supported": true,
"parsed_calendar_supported": true,
"dashcam_clip_save_available": true,
"summon_standby_mode_enabled": true
},
"backseat_token": "string",
"vehicle_config": {
"plg": true,
"pws": true,
"rhd": true,
"car_type": "modelx",
"seat_type": 0,
"timestamp": 1643590652755,
"eu_vehicle": true,
"roof_color": "None",
"utc_offset": -28800,
"wheel_type": "Turbine22Dark",
"spoiler_type": "Passive",
"trim_badging": "p100d",
"driver_assist": "TeslaAP3",
"headlamp_type": "Led",
"exterior_color": "Pearl",
"rear_seat_type": 7,
"rear_drive_unit": "Large",
"third_row_seats": "FuturisFoldFlat",
"car_special_type": "base",
"charge_port_type": "US",
"ece_restrictions": true,
"front_drive_unit": "PermanentMagnet",
"has_seat_cooling": true,
"rear_seat_heaters": 3,
"use_range_badging": true,
"can_actuate_trunks": true,
"efficiency_package": "Default",
"has_air_suspension": true,
"has_ludicrous_mode": true,
"interior_trim_type": "AllBlack",
"sun_roof_installed": 0,
"default_charge_to_max": true,
"motorized_charge_port": true,
"dashcam_clip_save_supported": true,
"can_accept_navigation_requests": true
},
"calendar_enabled": true,
"backseat_token_updated_at": "string"
}Returns the latest state of a vehicle.
If use_cache is true (default), this call always returns a complete set of data and doesn’t impact vehicle sleep. If the vehicle is awake, the data is usually less than 15 seconds old. If the vehicle is asleep, the data is from the time the vehicle went to sleep.
If use_cache is false, this call retrieves data using a live connection, which may return {"state": "asleep"} or network errors depending on vehicle connectivity.
curl --request GET \
--url https://api.tessie.com/{vin}/state \
--header 'Authorization: Bearer <token>'{
"id": 1492931520123456,
"vin": "5YJXCAE43LF123456",
"id_s": "1492931520123456",
"color": "string",
"state": "online",
"user_id": 1311857,
"in_service": true,
"vehicle_id": 1349238573,
"access_type": "OWNER",
"api_version": 34,
"drive_state": {
"power": 0,
"speed": "string",
"heading": 194,
"latitude": 40.7484,
"gps_as_of": 1643590638,
"longitude": 73.9857,
"timestamp": 1643590652755,
"native_type": "wgs",
"shift_state": "P",
"native_latitude": 40.7484,
"native_longitude": 73.9857,
"native_location_supported": 1,
"active_route_destination": "Empire State Building",
"active_route_energy_at_arrival": 81,
"active_route_latitude": -1.123456,
"active_route_longitude": 1.123456,
"active_route_miles_to_arrival": 4.12,
"active_route_minutes_to_arrival": 5.43,
"active_route_traffic_minutes_delay": 0
},
"charge_state": {
"timestamp": 1643590652755,
"charge_amps": 12,
"charge_rate": 0,
"battery_level": 89,
"battery_range": 269.01,
"charger_power": 0,
"trip_charging": true,
"charger_phases": "string",
"charging_state": "Complete",
"charger_voltage": 0,
"charge_limit_soc": 90,
"battery_heater_on": true,
"charge_port_color": "Off",
"charge_port_latch": "Engaged",
"conn_charge_cable": "SAE",
"est_battery_range": 223.25,
"fast_charger_type": "MCSingleWireCAN",
"fast_charger_brand": "<invalid>",
"charge_energy_added": 4.64,
"charge_to_max_range": true,
"ideal_battery_range": 999,
"time_to_full_charge": 0,
"charge_limit_soc_max": 100,
"charge_limit_soc_min": 50,
"charge_limit_soc_std": 90,
"fast_charger_present": true,
"usable_battery_level": 89,
"charge_enable_request": true,
"charge_port_door_open": true,
"charger_pilot_current": 12,
"preconditioning_times": "weekdays",
"charge_current_request": 12,
"charger_actual_current": 0,
"minutes_to_full_charge": 0,
"managed_charging_active": true,
"off_peak_charging_times": "all_week",
"off_peak_hours_end_time": 375,
"preconditioning_enabled": true,
"scheduled_charging_mode": "Off",
"charge_miles_added_ideal": 4641,
"charge_miles_added_rated": 14.5,
"max_range_charge_counter": 0,
"not_enough_power_to_heat": true,
"scheduled_departure_time": 1643578200,
"off_peak_charging_enabled": true,
"charge_current_request_max": 12,
"scheduled_charging_pending": true,
"user_charge_enable_request": "string",
"managed_charging_start_time": "string",
"charge_port_cold_weather_mode": "string",
"scheduled_charging_start_time": "string",
"managed_charging_user_canceled": true,
"scheduled_departure_time_minutes": 810,
"scheduled_charging_start_time_app": 817,
"supercharger_session_trip_planner": true,
"pack_current": -0.7,
"pack_voltage": 419.79,
"module_temp_min": 25.5,
"module_temp_max": 26,
"energy_remaining": 51.26,
"lifetime_energy_used": 5224.713
},
"display_name": "Seneca",
"gui_settings": {
"timestamp": 1643590652755,
"gui_24_hour_time": true,
"show_range_units": true,
"gui_range_display": "Rated",
"gui_distance_units": "mi/hr",
"gui_charge_rate_units": "kW",
"gui_temperature_units": "F"
},
"option_codes": "AD15MDL3PBSBRENABT37ID3WRF3GS3PBDRLHDV2WW39BAPF0COUSBC3BCH07PC30FC3PFG31GLFRHL31HM31IL31LTPBMR31FM3BRS3HSA3PSTCPSC04SU3CT3CATW00TM00UT3PWR00AU3PAPH3AF00ZCSTMI00CDM0",
"climate_state": {
"timestamp": 1643590652755,
"fan_status": 0,
"inside_temp": 24.3,
"defrost_mode": 0,
"outside_temp": 17.5,
"is_climate_on": true,
"battery_heater": true,
"bioweapon_mode": true,
"max_avail_temp": 28,
"min_avail_temp": 15,
"seat_heater_left": 0,
"hvac_auto_request": "On",
"seat_heater_right": 0,
"is_preconditioning": true,
"wiper_blade_heater": true,
"climate_keeper_mode": "off",
"driver_temp_setting": 22.8,
"left_temp_direction": 0,
"side_mirror_heaters": true,
"is_rear_defroster_on": true,
"right_temp_direction": 0,
"is_front_defroster_on": true,
"seat_heater_rear_left": 0,
"steering_wheel_heater": true,
"passenger_temp_setting": 22.8,
"seat_heater_rear_right": 0,
"battery_heater_no_power": true,
"is_auto_conditioning_on": true,
"seat_heater_rear_center": 0,
"cabin_overheat_protection": "On",
"seat_heater_third_row_left": 0,
"seat_heater_third_row_right": 0,
"remote_heater_control_enabled": true,
"allow_cabin_overheat_protection": true,
"supports_fan_only_cabin_overheat_protection": true
},
"vehicle_state": {
"df": 0,
"dr": 0,
"ft": 0,
"pf": 0,
"pr": 0,
"rt": 0,
"locked": true,
"odometer": 14096.485641,
"fd_window": 0,
"fp_window": 0,
"rd_window": 0,
"rp_window": 0,
"timestamp": 1643590652755,
"santa_mode": 0,
"valet_mode": true,
"api_version": 34,
"car_version": "2022.4 fae2af490933",
"media_state": {
"remote_control_enabled": true
},
"sentry_mode": true,
"remote_start": true,
"vehicle_name": "Seneca",
"dashcam_state": "Unavailable",
"autopark_style": "standard",
"homelink_nearby": true,
"is_user_present": true,
"software_update": {
"status": "available",
"version": "2022.4",
"install_perc": 1,
"download_perc": 0,
"expected_duration_sec": 2700
},
"speed_limit_mode": {
"active": true,
"pin_code_set": true,
"max_limit_mph": 90,
"min_limit_mph": 50,
"current_limit_mph": 84
},
"tpms_pressure_fl": "string",
"tpms_pressure_fr": "string",
"tpms_pressure_rl": "string",
"tpms_pressure_rr": "string",
"autopark_state_v2": "standby",
"calendar_supported": true,
"last_autopark_error": "no_error",
"center_display_state": 0,
"remote_start_enabled": true,
"homelink_device_count": 0,
"sentry_mode_available": true,
"remote_start_supported": true,
"smart_summon_available": true,
"notifications_supported": true,
"parsed_calendar_supported": true,
"dashcam_clip_save_available": true,
"summon_standby_mode_enabled": true
},
"backseat_token": "string",
"vehicle_config": {
"plg": true,
"pws": true,
"rhd": true,
"car_type": "modelx",
"seat_type": 0,
"timestamp": 1643590652755,
"eu_vehicle": true,
"roof_color": "None",
"utc_offset": -28800,
"wheel_type": "Turbine22Dark",
"spoiler_type": "Passive",
"trim_badging": "p100d",
"driver_assist": "TeslaAP3",
"headlamp_type": "Led",
"exterior_color": "Pearl",
"rear_seat_type": 7,
"rear_drive_unit": "Large",
"third_row_seats": "FuturisFoldFlat",
"car_special_type": "base",
"charge_port_type": "US",
"ece_restrictions": true,
"front_drive_unit": "PermanentMagnet",
"has_seat_cooling": true,
"rear_seat_heaters": 3,
"use_range_badging": true,
"can_actuate_trunks": true,
"efficiency_package": "Default",
"has_air_suspension": true,
"has_ludicrous_mode": true,
"interior_trim_type": "AllBlack",
"sun_roof_installed": 0,
"default_charge_to_max": true,
"motorized_charge_port": true,
"dashcam_clip_save_supported": true,
"can_accept_navigation_requests": true
},
"calendar_enabled": true,
"backseat_token_updated_at": "string"
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
The associated VIN.
Whether to return the most recently seen data. Set to false to retrieve the vehicle state in real-time. If true, doesn't impact vehicle sleep and always returns a complete set of data. Applies to legacy Tesla Model S and Model X only.
Success
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes