Skip to main content
GET
/
{vin}
/
state
Get Vehicle
curl --request GET \
  --url https://api.tessie.com/{vin}/state \
  --header 'Authorization: Bearer <token>'
{
  "id": 123,
  "vin": "<string>",
  "id_s": "<string>",
  "color": "<string>",
  "state": "<string>",
  "user_id": 123,
  "in_service": true,
  "vehicle_id": 123,
  "access_type": "<string>",
  "api_version": 123,
  "drive_state": {
    "power": 123,
    "speed": "<string>",
    "heading": 123,
    "latitude": 123,
    "gps_as_of": 123,
    "longitude": 123,
    "timestamp": 123,
    "native_type": "<string>",
    "shift_state": "<string>",
    "native_latitude": 123,
    "native_longitude": 123,
    "native_location_supported": 123,
    "active_route_destination": "<string>",
    "active_route_energy_at_arrival": 123,
    "active_route_latitude": 123,
    "active_route_longitude": 123,
    "active_route_miles_to_arrival": 123,
    "active_route_minutes_to_arrival": 123,
    "active_route_traffic_minutes_delay": 123
  },
  "charge_state": {
    "timestamp": 123,
    "charge_amps": 123,
    "charge_rate": 123,
    "battery_level": 123,
    "battery_range": 123,
    "charger_power": 123,
    "trip_charging": true,
    "charger_phases": "<string>",
    "charging_state": "<string>",
    "charger_voltage": 123,
    "charge_limit_soc": 123,
    "battery_heater_on": true,
    "charge_port_color": "<string>",
    "charge_port_latch": "<string>",
    "conn_charge_cable": "<string>",
    "est_battery_range": 123,
    "fast_charger_type": "<string>",
    "fast_charger_brand": "<string>",
    "charge_energy_added": 123,
    "charge_to_max_range": true,
    "ideal_battery_range": 123,
    "time_to_full_charge": 123,
    "charge_limit_soc_max": 123,
    "charge_limit_soc_min": 123,
    "charge_limit_soc_std": 123,
    "fast_charger_present": true,
    "usable_battery_level": 123,
    "charge_enable_request": true,
    "charge_port_door_open": true,
    "charger_pilot_current": 123,
    "preconditioning_times": "<string>",
    "charge_current_request": 123,
    "charger_actual_current": 123,
    "minutes_to_full_charge": 123,
    "managed_charging_active": true,
    "off_peak_charging_times": "<string>",
    "off_peak_hours_end_time": 123,
    "preconditioning_enabled": true,
    "scheduled_charging_mode": "<string>",
    "charge_miles_added_ideal": 123,
    "charge_miles_added_rated": 123,
    "max_range_charge_counter": 123,
    "not_enough_power_to_heat": true,
    "scheduled_departure_time": 123,
    "off_peak_charging_enabled": true,
    "charge_current_request_max": 123,
    "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": 123,
    "scheduled_charging_start_time_app": 123,
    "supercharger_session_trip_planner": true,
    "pack_current": 123,
    "pack_voltage": 123,
    "module_temp_min": 123,
    "module_temp_max": 123,
    "energy_remaining": 123,
    "lifetime_energy_used": 123
  },
  "display_name": "<string>",
  "gui_settings": {
    "timestamp": 123,
    "gui_24_hour_time": true,
    "show_range_units": true,
    "gui_range_display": "<string>",
    "gui_distance_units": "<string>",
    "gui_charge_rate_units": "<string>",
    "gui_temperature_units": "<string>"
  },
  "option_codes": "<string>",
  "climate_state": {
    "timestamp": 123,
    "fan_status": 123,
    "inside_temp": 123,
    "defrost_mode": 123,
    "outside_temp": 123,
    "is_climate_on": true,
    "battery_heater": true,
    "bioweapon_mode": true,
    "max_avail_temp": 123,
    "min_avail_temp": 123,
    "seat_heater_left": 123,
    "hvac_auto_request": "<string>",
    "seat_heater_right": 123,
    "is_preconditioning": true,
    "wiper_blade_heater": true,
    "climate_keeper_mode": "<string>",
    "driver_temp_setting": 123,
    "left_temp_direction": 123,
    "side_mirror_heaters": true,
    "is_rear_defroster_on": true,
    "right_temp_direction": 123,
    "is_front_defroster_on": true,
    "seat_heater_rear_left": 123,
    "steering_wheel_heater": true,
    "passenger_temp_setting": 123,
    "seat_heater_rear_right": 123,
    "battery_heater_no_power": true,
    "is_auto_conditioning_on": true,
    "seat_heater_rear_center": 123,
    "cabin_overheat_protection": "<string>",
    "seat_heater_third_row_left": 123,
    "seat_heater_third_row_right": 123,
    "remote_heater_control_enabled": true,
    "allow_cabin_overheat_protection": true,
    "supports_fan_only_cabin_overheat_protection": true
  },
  "vehicle_state": {
    "df": 123,
    "dr": 123,
    "ft": 123,
    "pf": 123,
    "pr": 123,
    "rt": 123,
    "locked": true,
    "odometer": 123,
    "fd_window": 123,
    "fp_window": 123,
    "rd_window": 123,
    "rp_window": 123,
    "timestamp": 123,
    "santa_mode": 123,
    "valet_mode": true,
    "api_version": 123,
    "car_version": "<string>",
    "media_state": {
      "remote_control_enabled": true
    },
    "sentry_mode": true,
    "remote_start": true,
    "vehicle_name": "<string>",
    "dashcam_state": "<string>",
    "autopark_style": "<string>",
    "homelink_nearby": true,
    "is_user_present": true,
    "software_update": {
      "status": "<string>",
      "version": "<string>",
      "install_perc": 123,
      "download_perc": 123,
      "expected_duration_sec": 123
    },
    "speed_limit_mode": {
      "active": true,
      "pin_code_set": true,
      "max_limit_mph": 123,
      "min_limit_mph": 123,
      "current_limit_mph": 123
    },
    "tpms_pressure_fl": "<string>",
    "tpms_pressure_fr": "<string>",
    "tpms_pressure_rl": "<string>",
    "tpms_pressure_rr": "<string>",
    "autopark_state_v2": "<string>",
    "calendar_supported": true,
    "last_autopark_error": "<string>",
    "center_display_state": 123,
    "remote_start_enabled": true,
    "homelink_device_count": 123,
    "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": "<string>",
    "seat_type": 123,
    "timestamp": 123,
    "eu_vehicle": true,
    "roof_color": "<string>",
    "utc_offset": 123,
    "wheel_type": "<string>",
    "spoiler_type": "<string>",
    "trim_badging": "<string>",
    "driver_assist": "<string>",
    "headlamp_type": "<string>",
    "exterior_color": "<string>",
    "rear_seat_type": 123,
    "rear_drive_unit": "<string>",
    "third_row_seats": "<string>",
    "car_special_type": "<string>",
    "charge_port_type": "<string>",
    "ece_restrictions": true,
    "front_drive_unit": "<string>",
    "has_seat_cooling": true,
    "rear_seat_heaters": 123,
    "use_range_badging": true,
    "can_actuate_trunks": true,
    "efficiency_package": "<string>",
    "has_air_suspension": true,
    "has_ludicrous_mode": true,
    "interior_trim_type": "<string>",
    "sun_roof_installed": 123,
    "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

Set to false to retrieve vehicle state in real-time. Legacy Model S and Model X only.

Response

200 - application/json

Success

id
integer
vin
string
id_s
string
color
string
state
string
user_id
integer
in_service
boolean
vehicle_id
integer
access_type
string
api_version
integer
drive_state
object
charge_state
object
display_name
string
gui_settings
object
option_codes
string
climate_state
object
vehicle_state
object
backseat_token
string
vehicle_config
object
calendar_enabled
boolean
backseat_token_updated_at
string