Information


GET https://teslascope.com/api/vehicle/:public_id
This is an object representing a vehicle on the Teslascope service. You can retrieve it to access basic information if a vehicle is public, or additional information if an authenticated request is made.

name
string
String representing the vehicle's name, provided by the owner.
public_id
string
The unique identifier of the vehicle.
odometer
decimal
The odometer reading of the vehicle.
model
string
The model of the vehicle (ie: Model 3).
trim
string
The specific trim of the vehicle (ie: Performance).
year
integer
The year designated by the VIN.
car_version
string
The current software update version.
battery
array
Contains variables regarding battery / charging information.
  • level
  • range
  • charge_limit_soc
  • charging_state
  • minutes_remaining
  • time_remaining
  • scheduled_charging_pending
  • scheduled_charging_start_time
climate
array
Contains variables regarding climate information.
  • inside
  • outside
  • is_auto_conditioning_on
  • is_climate_on
  • is_front_defroster_on
  • is_rear_refroster_on
  • seat_heaters (array)
statistics
array
Contains various statistics about the vehicle.
  • drives
  • distance
  • drives_duration
  • charges
  • supercharging
  • charges_duration
  • charges_kwh
  • joined
  • hw (hardware)
vehicle
array
Contains variables regarding vehicle status.
  • locked
  • sentry_mode
  • latitude
  • longitude
  • is_user_present
  • windows (array)
  • config (array)
render_url
string
The URL used to render this vehicle.
{
  "code": 200,
  "response": {
    "name": "Nautilus",
    "public_id": "corsair",
    "odometer": 32316.33,
    "model": "Model 3",
    "trim": "Performance",
    "year": "2018",
    "car_version": "2020.28.5",
    "battery": {
      "level": 59,
      "range": "170.09",
      "charge_limit_soc": 71,
      "charging_state": "Disconnected",
      "minutes_remaining": 0,
      "time_remaining": "0.00",
      "scheduled_charging_pending": false,
      "scheduled_charging_start_time": null
    },
    "climate": {
      "inside": 78.8,
      "outside": 78.8,
      "is_auto_conditioning_on": false,
      "is_climate_on": false,
      "is_front_defroster_on": false,
      "is_rear_defroster_on": false,
      "seat_heaters": {
        "left": 0,
        "right": 0,
        "left_rear": 0,
        "center_rear": 0,
        "right_rear": 0
      }
    },
    "render_url": "https://teslascope.com/render-vehicle/corsair/large",
    "software": {
      "status": "",
      "version": "",
      "download_percentage": 0,
      "install_percentage": 1
    },
    "statistics": {
      "drives": 1327,
      "distance": 20928.12,
      "drives_duration": 2005344,
      "charges": 183,
      "supercharging": 143,
      "charges_duration": 6204314,
      "charges_kwh": 6925.89,
      "joined": "64 weeks and 6 days",
      "hw": "3.0"
    },
    "vehicle": {
      "locked": true,
      "sentry_mode": false,
      "latitude": <redacted>,
      "longitude": <redacted>,
      "is_user_present": false,
      "windows": {
        "driver_front": false,
        "driver_rear": false,
        "passenger_front": false,
        "passenger_rear": false
      },
      "config": {
        "color": "MidnightSilver",
        "color_name": "Midnight Silver",
        "wheels": "Pinwheel18",
        "spoiler": "None",
        "roof_color": "Glass"
      }
    }
  }
}