Data

GET /api/1/vehicles/{id}/vehicle_data

A rollup of all the data_request endpoints plus vehicle configuration.

Note: all *_range values are in miles, irrespective of GUI configuration.

Response

{
  "response": {
    "id": 12345678901234567,
    "user_id": 123,
    "vehicle_id": 1234567890,
    "vin": "5YJSA11111111111",
    "display_name": "Nikola 2.0",
    "color": null,
    "access_type": "OWNER",
    "tokens": ["abcdef1234567890", "1234567890abcdef"],
    "state": "online",
    "in_service": false,
    "id_s": "12345678901234567",
    "calendar_enabled": true,
    "api_version": 13,
    "backseat_token": null,
    "backseat_token_updated_at": null,
    "drive_state": {
      "gps_as_of": 1607623884,
      "heading": 5,
      "latitude": 33.111111,
      "longitude": -88.111111,
      "native_latitude": 33.111111,
      "native_location_supported": 1,
      "native_longitude": -88.111111,
      "native_type": "wgs",
      "power": -9,
      "shift_state": null,
      "speed": null,
      "timestamp": 1607623897515
    },
    "climate_state": {
      "battery_heater": false,
      "battery_heater_no_power": false,
      "climate_keeper_mode": "off",
      "defrost_mode": 0,
      "driver_temp_setting": 21.1,
      "fan_status": 0,
      "inside_temp": 22.1,
      "is_auto_conditioning_on": false,
      "is_climate_on": false,
      "is_front_defroster_on": false,
      "is_preconditioning": false,
      "is_rear_defroster_on": false,
      "left_temp_direction": -66,
      "max_avail_temp": 28.0,
      "min_avail_temp": 15.0,
      "outside_temp": 18.0,
      "passenger_temp_setting": 21.1,
      "remote_heater_control_enabled": false,
      "right_temp_direction": -66,
      "seat_heater_left": 0,
      "seat_heater_right": 0,
      "side_mirror_heaters": false,
      "timestamp": 1607623897515,
      "wiper_blade_heater": false
    },
    "charge_state": {
      "battery_heater_on": false,
      "battery_level": 59,
      "battery_range": 149.92,
      "charge_current_request": 40,
      "charge_current_request_max": 40,
      "charge_enable_request": true,
      "charge_energy_added": 2.42,
      "charge_limit_soc": 90,
      "charge_limit_soc_max": 100,
      "charge_limit_soc_min": 50,
      "charge_limit_soc_std": 90,
      "charge_miles_added_ideal": 10.0,
      "charge_miles_added_rated": 8.0,
      "charge_port_cold_weather_mode": null,
      "charge_port_door_open": true,
      "charge_port_latch": "Engaged",
      "charge_rate": 28.0,
      "charge_to_max_range": false,
      "charger_actual_current": 40,
      "charger_phases": 1,
      "charger_pilot_current": 40,
      "charger_power": 9,
      "charger_voltage": 243,
      "charging_state": "Charging",
      "conn_charge_cable": "SAE",
      "est_battery_range": 132.98,
      "fast_charger_brand": "<invalid>",
      "fast_charger_present": false,
      "fast_charger_type": "<invalid>",
      "ideal_battery_range": 187.4,
      "managed_charging_active": false,
      "managed_charging_start_time": null,
      "managed_charging_user_canceled": false,
      "max_range_charge_counter": 0,
      "minutes_to_full_charge": 165,
      "not_enough_power_to_heat": false,
      "scheduled_charging_pending": false,
      "scheduled_charging_start_time": null,
      "time_to_full_charge": 2.75,
      "timestamp": 1607623897515,
      "trip_charging": false,
      "usable_battery_level": 59,
      "user_charge_enable_request": null
    },
    "gui_settings": {
      "gui_24_hour_time": false,
      "gui_charge_rate_units": "mi/hr",
      "gui_distance_units": "mi/hr",
      "gui_range_display": "Rated",
      "gui_temperature_units": "F",
      "show_range_units": true,
      "timestamp": 1607623897515
    },
    "vehicle_state": {
      "api_version": 13,
      "autopark_state_v2": "standby",
      "autopark_style": "standard",
      "calendar_supported": true,
      "car_version": "2020.48.10 f8900cddd03a",
      "center_display_state": 0,
      "df": 0,
      "dr": 0,
      "fd_window": 0,
      "fp_window": 0,
      "ft": 0,
      "homelink_device_count": 2,
      "homelink_nearby": true,
      "is_user_present": false,
      "last_autopark_error": "no_error",
      "locked": false,
      "media_state": { "remote_control_enabled": true },
      "notifications_supported": true,
      "odometer": 57869.762487,
      "parsed_calendar_supported": true,
      "pf": 0,
      "pr": 0,
      "rd_window": 0,
      "remote_start": false,
      "remote_start_enabled": true,
      "remote_start_supported": true,
      "rp_window": 0,
      "rt": 0,
      "sentry_mode": false,
      "sentry_mode_available": true,
      "smart_summon_available": true,
      "software_update": {
        "download_perc": 0,
        "expected_duration_sec": 2700,
        "install_perc": 1,
        "status": "",
        "version": ""
      },
      "speed_limit_mode": {
        "active": false,
        "current_limit_mph": 85.0,
        "max_limit_mph": 90,
        "min_limit_mph": 50,
        "pin_code_set": false
      },
      "summon_standby_mode_enabled": false,
      "sun_roof_percent_open": 0,
      "sun_roof_state": "closed",
      "timestamp": 1607623897515,
      "valet_mode": false,
      "valet_pin_needed": true,
      "vehicle_name": null
    },
    "vehicle_config": {
      "can_accept_navigation_requests": true,
      "can_actuate_trunks": true,
      "car_special_type": "base",
      "car_type": "models2",
      "charge_port_type": "US",
      "default_charge_to_max": false,
      "ece_restrictions": false,
      "eu_vehicle": false,
      "exterior_color": "White",
      "has_air_suspension": true,
      "has_ludicrous_mode": false,
      "motorized_charge_port": true,
      "plg": true,
      "rear_seat_heaters": 0,
      "rear_seat_type": 0,
      "rhd": false,
      "roof_color": "None",
      "seat_type": 2,
      "spoiler_type": "None",
      "sun_roof_installed": 2,
      "third_row_seats": "None",
      "timestamp": 1607623897515,
      "trim_badging": "p90d",
      "use_range_badging": false,
      "wheel_type": "AeroTurbine19"
    }
  }
}

GET /api/1/vehicles/{id}/data

A "legacy" version of the data endpoint.

Response

Currently, this has the exact same response structure as the newer vehicle_data endpoint.

GET /api/1/vehicles/{id}/latest_vehicle_data

This endpoint was deprecated in favor of the vehicle_data endpoint and returns 404.

This is cached data, pushed by the vehicle on sleep, wake and around OTAs.

Response

{
  "response": {
    "version": 9,
    "pb_data": "Appears to be Base64 encoded protobuf data (malformed b64 string)",
    "data": {
      "charge_state": {
        "battery_heater_on": false,
        "battery_level": 0,
        "battery_range": 0.0,
        "charge_current_request": 0,
        "charge_current_request_max": 0,
        "charge_enable_request": false,
        "charge_energy_added": 0.0,
        "charge_limit_soc": 0,
        "charge_limit_soc_max": 0,
        "charge_limit_soc_min": 0,
        "charge_limit_soc_std": 0,
        "charge_miles_added_ideal": 0.0,
        "charge_miles_added_rated": 0.0,
        "charge_port_cold_weather_mode": false,
        "charge_port_color": "Off",
        "charge_port_door_open": false,
        "charge_port_latch": "Blocking",
        "charge_rate": 0,
        "charge_to_max_range": false,
        "charger_actual_current": 0,
        "charger_phases": 0,
        "charger_pilot_current": 0,
        "charger_power": 0,
        "charger_voltage": 0,
        "charge_amps": 0,
        "charging_state": "Disconnected",
        "conn_charge_cable": "IEC",
        "est_battery_range": 0.0,
        "fast_charger_brand": "SNA",
        "fast_charger_present": false,
        "fast_charger_type": "Supercharger",
        "ideal_battery_range": 0.0,
        "managed_charging_active": false,
        "managed_charging_start_time": 0,
        "managed_charging_user_canceled": false,
        "max_range_charge_counter": 0,
        "minutes_to_full_charge": 0,
        "time_to_full_charge": 0.0,
        "not_enough_power_to_heat": false,
        "off_peak_charging_enabled": false,
        "off_peak_charging_times": "all_week",
        "off_peak_hours_end_time": 0,
        "preconditioning_enabled": false,
        "preconditioning_times": "all_week",
        "scheduled_charging_mode": "Off",
        "scheduled_charging_pending": false,
        "scheduled_charging_start_time": 0,
        "scheduled_charging_start_time_app": 0,
        "scheduled_charging_start_time_minutes": 0,
        "scheduled_departure_time": 1656223200000,
        "scheduled_departure_time_minutes": 0,
        "supercharger_session_trip_planner": false,
        "timestamp": 1665664828457,
        "trip_charging": false,
        "usable_battery_level": 0,
        "user_charge_enable_request": false
      },
      "climate_state": {
        "allow_cabin_overheat_protection": false,
        "auto_seat_climate_left": false,
        "auto_seat_climate_right": false,
        "battery_heater": false,
        "battery_heater_no_power": false,
        "bioweapon_mode": false,
        "cabin_overheat_protection": "Off",
        "cabin_overheat_protection_actively_cooling": false,
        "climate_keeper_mode": "unknown",
        "defrost_mode": 0,
        "driver_temp_setting": 0.0,
        "hvac_auto_request": "On",
        "fan_status": 0,
        "inside_temp": 0.0,
        "is_auto_conditioning_on": false,
        "is_climate_on": false,
        "is_front_defroster_on": false,
        "is_preconditioning": false,
        "is_rear_defroster_on": false,
        "left_temp_direction": 0,
        "max_avail_temp": 0.0,
        "min_avail_temp": 0.0,
        "outside_temp": 0.0,
        "passenger_temp_setting": 0.0,
        "remote_heater_control_enabled": false,
        "right_temp_direction": 0,
        "seat_fan_front_left": 0,
        "seat_fan_front_right": 0,
        "seat_heater_left": 0,
        "seat_heater_rear_center": 0,
        "seat_heater_rear_left": 0,
        "seat_heater_rear_left_back": 0,
        "seat_heater_rear_right": 0,
        "seat_heater_rear_right_back": 0,
        "seat_heater_right": 0,
        "seat_heater_third_row_left": 0,
        "seat_heater_third_row_right": 0,
        "side_mirror_heaters": false,
        "supports_fan_only_cabin_overheat_protection": false,
        "timestamp": 1665664828457,
        "wiper_blade_heater": false,
        "steering_wheel_heater": null
      },
      "closures_state": {
        "timestamp": 1665664828458
      },
      "drive_state": {
        "power": 0,
        "speed": 0
      },
      "gui_settings": {
        "gui_24_hour_time": false,
        "gui_charge_rate_units": "km/hr",
        "gui_distance_units": "km/hr",
        "gui_range_display": "Ideal",
        "gui_temperature_units": "C",
        "show_range_units": false,
        "timestamp": 1665664828459
      },
      "vehicle_config": {
        "aux_park_lamps": "NaBase",
        "badge_version": 0,
        "bioweapon_mode_supported": false,
        "can_accept_navigation_requests": false,
        "can_actuate_trunks": false,
        "car_special_type": "base",
        "car_type": "modelx",
        "charge_port_type": "EU",
        "dashcam_clip_save_supported": false,
        "default_charge_to_max": false,
        "driver_assist": "ParkerPascal2_5",
        "ece_restrictions": false,
        "efficiency_package": "Default",
        "eu_vehicle": false,
        "exterior_color": "MetallicBlack",
        "front_drive_unit": "NoneOrSmall",
        "has_air_suspension": false,
        "has_ludicrous_mode": false,
        "pws": false,
        "headlamp_type": "Premium",
        "has_seat_cooling": false,
        "interior_trim_type": "AllBlack",
        "is_raven": false,
        "key_version": 0,
        "motorized_charge_port": false,
        "plg": false,
        "range_plus_badging": false,
        "rear_drive_unit": "Small",
        "rear_seat_heaters": 3,
        "rear_seat_type": 3,
        "rhd": false,
        "roof_color": "None",
        "seat_type": 0,
        "spoiler_type": "Passive",
        "sun_roof_installed": 0,
        "supports_qr_pairing": false,
        "third_row_seats": "FuturisFoldFlat",
        "timestamp": 1665664828459,
        "trim_badging": "plaid",
        "use_range_badging": false,
        "utc_offset": 0,
        "webcam_supported": false,
        "wheel_type": "Turbine22"
      },
      "vehicle_state": {
        "homelink_device_count": 0,
        "tpms_pressure_fl": 0.0,
        "tpms_pressure_fr": 0.0,
        "tpms_pressure_rl": 0.0,
        "tpms_pressure_rr": 0.0,
        "webcam_available": false,
        "api_version": 0,
        "autopark_state_v2": "ready",
        "autopark_style": "dead_man",
        "calendar_supported": false,
        "center_display_state": 0,
        "dashcam_clip_save_available": false,
        "dashcam_state": "Unavailable",
        "df": false,
        "dr": false,
        "fd_window": false,
        "feature_bitmask": "1047039,0",
        "fp_window": false,
        "ft": false,
        "is_user_present": false,
        "locked": false,
        "media_state": {
          "remote_control_enabled": false
        },
        "notifications_supported": false,
        "odometer": 0.0,
        "parsed_calendar_supported": false,
        "patsy_mode": false,
        "pf": false,
        "pr": false,
        "rd_window": false,
        "remote_start": false,
        "remote_start_enabled": false,
        "remote_start_supported": false,
        "rp_window": false,
        "rt": false,
        "sentry_mode": null,
        "sentry_mode_available": null,
        "service_mode": false,
        "service_mode_plus": false,
        "smart_summon_available": false,
        "software_update": {
          "download_perc": 0,
          "expected_duration_sec": 0,
          "install_perc": 0,
          "scheduled_time_ms": 0,
          "warning_time_remaining_ms": 0
        },
        "speed_limit_mode": {
          "active": false,
          "current_limit_mph": 0.0,
          "max_limit_mph": 0.0,
          "min_limit_mph": 0.0,
          "pin_code_set": false
        },
        "summon_standby_mode_enabled": false,
        "sun_roof_percent_open": 0,
        "timestamp": 1665664828459,
        "valet_mode": false,
        "valet_pin_needed": false,
        "vehicle_self_test_progress": 0,
        "vehicle_self_test_requested": false
      },
      "session_id": 0,
      "proto_json_version": 42,
      "id": 1234567890123456,
      "user_id": 123456,
      "vehicle_id": 1234567890,
      "vin": "7SAX..",
      "display_name": "Nikola",
      "color": null,
      "access_type": "OWNER",
      "tokens": ["12abcd3efgh4i5jk", "12a34bcd5678e900"],
      "state": "online",
      "in_service": false,
      "id_s": "1234567890123456",
      "calendar_enabled": true,
      "api_version": 48,
      "backseat_token": null,
      "backseat_token_updated_at": null
    },
    "legacy": {
      "id": 1234567890123456,
      "user_id": 123456,
      "vehicle_id": 1234567890,
      "vin": "7SA..",
      "display_name": "Nikola",
      "color": null,
      "access_type": "OWNER",
      "tokens": ["12abcd3efgh4i5jk", "12a34bcd5678e900"],
      "state": "online",
      "in_service": false,
      "id_s": "1234567890123456",
      "calendar_enabled": true,
      "api_version": 48,
      "backseat_token": null,
      "backseat_token_updated_at": null,
      "charge_state": {
        "battery_heater_on": false,
        "battery_level": 75,
        "battery_range": 242.3,
        "charge_amps": 24,
        "charge_current_request": 24,
        "charge_current_request_max": 24,
        "charge_enable_request": true,
        "charge_energy_added": 20.86,
        "charge_limit_soc": 100,
        "charge_limit_soc_max": 100,
        "charge_limit_soc_min": 50,
        "charge_limit_soc_std": 90,
        "charge_miles_added_ideal": 60.0,
        "charge_miles_added_rated": 75.0,
        "charge_port_cold_weather_mode": null,
        "charge_port_color": "Off",
        "charge_port_door_open": false,
        "charge_port_latch": "Blocking",
        "charge_rate": 0.0,
        "charger_actual_current": 0,
        "charger_phases": null,
        "charger_pilot_current": 24,
        "charger_power": 0,
        "charger_voltage": 0,
        "charging_state": "Disconnected",
        "conn_charge_cable": "<invalid>",
        "est_battery_range": 190.79,
        "fast_charger_brand": "<invalid>",
        "fast_charger_present": false,
        "fast_charger_type": "<invalid>",
        "ideal_battery_range": 194.06,
        "managed_charging_active": false,
        "managed_charging_start_time": null,
        "managed_charging_user_canceled": false,
        "max_range_charge_counter": 0,
        "minutes_to_full_charge": 0,
        "not_enough_power_to_heat": false,
        "off_peak_charging_enabled": false,
        "off_peak_charging_times": "all_week",
        "off_peak_hours_end_time": 360,
        "preconditioning_enabled": false,
        "preconditioning_times": "all_week",
        "scheduled_charging_mode": "Off",
        "scheduled_charging_pending": false,
        "scheduled_charging_start_time": null,
        "scheduled_departure_time": 1656223200,
        "scheduled_departure_time_minutes": 480,
        "supercharger_session_trip_planner": false,
        "time_to_full_charge": 0.0,
        "timestamp": 1665666097920,
        "trip_charging": false,
        "usable_battery_level": 75,
        "user_charge_enable_request": null
      },
      "climate_state": {
        "allow_cabin_overheat_protection": false,
        "battery_heater": false,
        "battery_heater_no_power": false,
        "bioweapon_mode": false,
        "cabin_overheat_protection": "Off",
        "climate_keeper_mode": "off",
        "cop_activation_temperature": "High",
        "defrost_mode": 0,
        "driver_temp_setting": 20.0,
        "fan_status": 0,
        "hvac_auto_request": "Override",
        "inside_temp": 22.3,
        "is_auto_conditioning_on": false,
        "is_climate_on": false,
        "is_front_defroster_on": false,
        "is_preconditioning": false,
        "is_rear_defroster_on": false,
        "left_temp_direction": -240,
        "max_avail_temp": 28.0,
        "min_avail_temp": 15.0,
        "outside_temp": 14.0,
        "passenger_temp_setting": 20.0,
        "remote_heater_control_enabled": false,
        "right_temp_direction": -240,
        "seat_heater_left": 0,
        "seat_heater_rear_left": 0,
        "seat_heater_rear_right": 0,
        "seat_heater_right": 0,
        "seat_heater_third_row_left": 0,
        "seat_heater_third_row_right": 0,
        "side_mirror_heaters": false,
        "steering_wheel_heater": false,
        "supports_fan_only_cabin_overheat_protection": false,
        "timestamp": 1,
        "wiper_blade_heater": false
      },
      "drive_state": {
        "active_route_latitude": 1,
        "active_route_longitude": 1,
        "active_route_traffic_minutes_delay": 0.0,
        "gps_as_of": 1,
        "heading": 212,
        "latitude": 1,
        "longitude": 1,
        "native_latitude": 1,
        "native_location_supported": 1,
        "native_longitude": 1,
        "native_type": "wgs",
        "power": 0,
        "shift_state": "P",
        "speed": null,
        "timestamp": 1665666097920
      },
      "gui_settings": {
        "gui_24_hour_time": true,
        "gui_charge_rate_units": "km/hr",
        "gui_distance_units": "km/hr",
        "gui_range_display": "Ideal",
        "gui_temperature_units": "C",
        "gui_tirepressure_units": "Bar",
        "show_range_units": true,
        "timestamp": 1665666097920
      },
      "vehicle_config": {
        "can_accept_navigation_requests": true,
        "can_actuate_trunks": true,
        "car_special_type": "base",
        "car_type": "modelx",
        "charge_port_type": "EU",
        "cop_user_set_temp_supported": false,
        "dashcam_clip_save_supported": true,
        "default_charge_to_max": false,
        "driver_assist": "ParkerPascal2_5",
        "ece_restrictions": true,
        "efficiency_package": "Default",
        "eu_vehicle": true,
        "exterior_color": "MetallicBlack",
        "exterior_trim_override": "Chrome",
        "front_drive_unit": "NoneOrSmall",
        "has_air_suspension": true,
        "has_ludicrous_mode": false,
        "has_seat_cooling": false,
        "headlamp_type": "Led",
        "interior_trim_type": "AllBlack",
        "motorized_charge_port": true,
        "paint_color_override": "14,14,14,0.9,0.01",
        "plg": true,
        "pws": false,
        "rear_drive_unit": "Small",
        "rear_seat_heaters": 3,
        "rear_seat_type": 3,
        "rhd": false,
        "roof_color": "None",
        "seat_type": 0,
        "spoiler_type": "Passive",
        "sun_roof_installed": 0,
        "supports_qr_pairing": false,
        "third_row_seats": "FuturisFoldFlat",
        "timestamp": 1665666097920,
        "trim_badging": "plaid",
        "use_range_badging": false,
        "utc_offset": 7200,
        "webcam_supported": false,
        "wheel_type": "Turbine22"
      },
      "vehicle_state": {
        "allow_authorized_mobile_devices_only": false,
        "api_version": 48,
        "autopark_state_v2": "ready",
        "autopark_style": "dead_man",
        "calendar_supported": true,
        "car_version": "2022.36.2 7a23b0656de1",
        "center_display_state": 0,
        "dashcam_clip_save_available": true,
        "dashcam_state": "Recording",
        "df": 0,
        "dr": 0,
        "fd_window": 0,
        "feature_bitmask": "ff9ff,0",
        "fp_window": 0,
        "ft": 0,
        "homelink_device_count": 1,
        "homelink_nearby": false,
        "is_user_present": false,
        "last_autopark_error": "no_error",
        "locked": true,
        "media_info": {
          "a2dp_source_name": "iPhone",
          "audio_volume": 2.0,
          "audio_volume_increment": 0.333333,
          "audio_volume_max": 10.333333,
          "media_playback_status": "Stopped",
          "now_playing_album": "",
          "now_playing_artist": "",
          "now_playing_duration": 0,
          "now_playing_elapsed": 0,
          "now_playing_source": "TuneIn",
          "now_playing_station": "",
          "now_playing_title": ""
        },
        "media_state": {
          "remote_control_enabled": true
        },
        "notifications_supported": true,
        "odometer": 1323.436653,
        "parsed_calendar_supported": true,
        "pf": 0,
        "pr": 0,
        "rd_window": 0,
        "remote_start": false,
        "remote_start_enabled": true,
        "remote_start_supported": true,
        "rp_window": 0,
        "rt": 0,
        "santa_mode": 0,
        "sentry_mode": true,
        "sentry_mode_available": true,
        "service_mode": false,
        "service_mode_plus": false,
        "smart_summon_available": true,
        "software_update": {
          "download_perc": 0,
          "expected_duration_sec": 2700,
          "install_perc": 1,
          "status": "",
          "version": " "
        },
        "speed_limit_mode": {
          "active": false,
          "current_limit_mph": 90.0,
          "max_limit_mph": 120,
          "min_limit_mph": 50.0,
          "pin_code_set": true
        },
        "summon_standby_mode_enabled": false,
        "timestamp": 1665666097920,
        "tpms_hard_warning_fl": false,
        "tpms_hard_warning_fr": false,
        "tpms_hard_warning_rl": false,
        "tpms_hard_warning_rr": false,
        "tpms_last_seen_pressure_time_fl": 1665665960,
        "tpms_last_seen_pressure_time_fr": 1665665960,
        "tpms_last_seen_pressure_time_rl": 1665665960,
        "tpms_last_seen_pressure_time_rr": 1665665960,
        "tpms_pressure_fl": 2.925,
        "tpms_pressure_fr": 2.925,
        "tpms_pressure_rl": 2.9,
        "tpms_pressure_rr": 2.925,
        "tpms_rcp_front_value": 2.9,
        "tpms_rcp_rear_value": 2.9,
        "tpms_soft_warning_fl": false,
        "tpms_soft_warning_fr": false,
        "tpms_soft_warning_rl": false,
        "tpms_soft_warning_rr": false,
        "valet_mode": false,
        "valet_pin_needed": false,
        "vehicle_name": "Nikola",
        "webcam_available": false
      }
    }
  }
}

Last updated