GET
/
{vin}
/
state
Get Vehicle
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"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
vin
string
required

The associated VIN.

Query Parameters

​
use_cache
boolean
default:true

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.

Response

200 - application/json

Success

The response is of type object.