---
title: "Get Vehicle"
method: GET
path: "/{vin}/state"
tags: ["Vehicle Data"]
---

# Get Vehicle

`GET /{vin}/state`

Returns the latest state of a vehicle.

## Path parameters

- `vin` string, required

## Query parameters

- `use_cache` boolean

## Response `200`

Success

- CurrentState
  - `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
    - `power` integer
    - `speed` string
    - `heading` integer
    - `latitude` number
    - `gps_as_of` integer
    - `longitude` number
    - `timestamp` integer
    - `native_type` string
    - `shift_state` string
    - `native_latitude` number
    - `native_longitude` number
    - `native_location_supported` integer
    - `active_route_destination` string
    - `active_route_energy_at_arrival` integer
    - `active_route_latitude` number
    - `active_route_longitude` number
    - `active_route_miles_to_arrival` number
    - `active_route_minutes_to_arrival` number
    - `active_route_traffic_minutes_delay` integer
  - `charge_state` object
    - `timestamp` integer
    - `charge_amps` integer
    - `charge_rate` integer
    - `battery_level` integer
    - `battery_range` number
    - `charger_power` integer
    - `trip_charging` boolean
    - `charger_phases` string
    - `charging_state` string
    - `charger_voltage` integer
    - `charge_limit_soc` integer
    - `battery_heater_on` boolean
    - `charge_port_color` string
    - `charge_port_latch` string
    - `conn_charge_cable` string
    - `est_battery_range` number
    - `fast_charger_type` string
    - `fast_charger_brand` string
    - `charge_energy_added` number
    - `charge_to_max_range` boolean
    - `ideal_battery_range` integer
    - `time_to_full_charge` integer
    - `charge_limit_soc_max` integer
    - `charge_limit_soc_min` integer
    - `charge_limit_soc_std` integer
    - `fast_charger_present` boolean
    - `usable_battery_level` integer
    - `charge_enable_request` boolean
    - `charge_port_door_open` boolean
    - `charger_pilot_current` integer
    - `preconditioning_times` string
    - `charge_current_request` integer
    - `charger_actual_current` integer
    - `minutes_to_full_charge` integer
    - `managed_charging_active` boolean
    - `off_peak_charging_times` string
    - `off_peak_hours_end_time` integer
    - `preconditioning_enabled` boolean
    - `scheduled_charging_mode` string
    - `charge_miles_added_ideal` integer
    - `charge_miles_added_rated` number
    - `max_range_charge_counter` integer
    - `not_enough_power_to_heat` boolean
    - `scheduled_departure_time` integer
    - `off_peak_charging_enabled` boolean
    - `charge_current_request_max` integer
    - `scheduled_charging_pending` boolean
    - `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` boolean
    - `scheduled_departure_time_minutes` integer
    - `scheduled_charging_start_time_app` integer
    - `supercharger_session_trip_planner` boolean
    - `pack_current` number
    - `pack_voltage` number
    - `module_temp_min` number
    - `module_temp_max` integer
    - `energy_remaining` number
    - `lifetime_energy_used` number
    - `phantom_drain` number
  - `display_name` string
  - `gui_settings` object
    - `timestamp` integer
    - `gui_24_hour_time` boolean
    - `show_range_units` boolean
    - `gui_range_display` string
    - `gui_distance_units` string
    - `gui_charge_rate_units` string
    - `gui_temperature_units` string
  - `option_codes` string
  - `climate_state` object
    - `timestamp` integer
    - `fan_status` integer
    - `inside_temp` number
    - `defrost_mode` integer
    - `outside_temp` number
    - `is_climate_on` boolean
    - `battery_heater` boolean
    - `bioweapon_mode` boolean
    - `max_avail_temp` integer
    - `min_avail_temp` integer
    - `seat_heater_left` integer
    - `hvac_auto_request` string
    - `seat_heater_right` integer
    - `is_preconditioning` boolean
    - `wiper_blade_heater` boolean
    - `climate_keeper_mode` string
    - `driver_temp_setting` number
    - `left_temp_direction` integer
    - `side_mirror_heaters` boolean
    - `is_rear_defroster_on` boolean
    - `right_temp_direction` integer
    - `is_front_defroster_on` boolean
    - `seat_heater_rear_left` integer
    - `steering_wheel_heater` boolean
    - `passenger_temp_setting` number
    - `seat_heater_rear_right` integer
    - `battery_heater_no_power` boolean
    - `is_auto_conditioning_on` boolean
    - `seat_heater_rear_center` integer
    - `cabin_overheat_protection` string
    - `seat_heater_third_row_left` integer
    - `seat_heater_third_row_right` integer
    - `remote_heater_control_enabled` boolean
    - `allow_cabin_overheat_protection` boolean
    - `supports_fan_only_cabin_overheat_protection` boolean
  - `vehicle_state` object
    - `df` integer
    - `dr` integer
    - `ft` integer
    - `pf` integer
    - `pr` integer
    - `rt` integer
    - `locked` boolean
    - `odometer` number
    - `fd_window` integer
    - `fp_window` integer
    - `rd_window` integer
    - `rp_window` integer
    - `timestamp` integer
    - `connection_status` 'wifi' | 'cellular' | 'connected' | 'disconnected', nullable
    - `santa_mode` integer
    - `valet_mode` boolean
    - `api_version` integer
    - `car_version` string
    - `media_state` object
      - `remote_control_enabled` boolean
    - `sentry_mode` boolean
    - `remote_start` boolean
    - `vehicle_name` string
    - `dashcam_state` string
    - `autopark_style` string
    - `homelink_nearby` boolean
    - `is_user_present` boolean
    - `software_update` object
      - `status` string
      - `version` string
      - `install_perc` integer
      - `download_perc` integer
      - `expected_duration_sec` integer
    - `speed_limit_mode` object
      - `active` boolean
      - `pin_code_set` boolean
      - `max_limit_mph` integer
      - `min_limit_mph` integer
      - `current_limit_mph` integer
    - `tpms_pressure_fl` string
    - `tpms_pressure_fr` string
    - `tpms_pressure_rl` string
    - `tpms_pressure_rr` string
    - `autopark_state_v2` string
    - `calendar_supported` boolean
    - `last_autopark_error` string
    - `center_display_state` integer
    - `remote_start_enabled` boolean
    - `homelink_device_count` integer
    - `sentry_mode_available` boolean
    - `remote_start_supported` boolean
    - `smart_summon_available` boolean
    - `notifications_supported` boolean
    - `parsed_calendar_supported` boolean
    - `dashcam_clip_save_available` boolean
    - `summon_standby_mode_enabled` boolean
  - `backseat_token` string
  - `vehicle_config` object
    - `plg` boolean
    - `pws` boolean
    - `rhd` boolean
    - `car_type` string
    - `seat_type` integer
    - `timestamp` integer
    - `eu_vehicle` boolean
    - `roof_color` string
    - `utc_offset` integer
    - `wheel_type` string
    - `spoiler_type` string
    - `trim_badging` string
    - `driver_assist` string
    - `headlamp_type` string
    - `exterior_color` string
    - `rear_seat_type` integer
    - `rear_drive_unit` string
    - `third_row_seats` string
    - `car_special_type` string
    - `charge_port_type` string
    - `ece_restrictions` boolean
    - `front_drive_unit` string
    - `has_seat_cooling` boolean
    - `rear_seat_heaters` integer
    - `use_range_badging` boolean
    - `can_actuate_trunks` boolean
    - `efficiency_package` string
    - `has_air_suspension` boolean
    - `has_ludicrous_mode` boolean
    - `interior_trim_type` string
    - `sun_roof_installed` integer
    - `default_charge_to_max` boolean
    - `motorized_charge_port` boolean
    - `dashcam_clip_save_supported` boolean
    - `can_accept_navigation_requests` boolean
  - `calendar_enabled` boolean
  - `backseat_token_updated_at` string

---

[API](https://skmtc.net/tessie/apis/tessie-api.md) · [All operations](https://skmtc.net/tessie/apis/tessie-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tessie/tessie-api/versions/a9157f7a53a2/schema)
