Skip to main content
GET
/
{vin}
/
states
Get Historical States
curl --request GET \
  --url https://api.tessie.com/{vin}/states \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "id": 9271662515,
      "timestamp": 1644010150,
      "state": "online",
      "charging_state": "Charging",
      "shift_state": "P",
      "version": "2022.4",
      "battery_level": 88,
      "usable_battery_level": 88,
      "battery_range": 266.69,
      "est_battery_range": 221.31,
      "ideal_battery_range": 999,
      "latitude": 40.7484,
      "longitude": 73.9857,
      "elevation": null,
      "heading": 213,
      "speed": null,
      "power": 0,
      "odometer": 14096.5,
      "charge_rate": 2,
      "charger_actual_current": 12,
      "charger_power": 1,
      "charger_phases": 1,
      "charger_voltage": 118,
      "charge_miles_added_rated": 1.5,
      "charge_miles_added_ideal": 422,
      "is_climate_on": 0,
      "is_preconditioning": 0,
      "battery_heater_on": 0,
      "inside_temp": 37.7,
      "outside_temp": 20.5,
      "left_temp_direction": 0,
      "right_temp_direction": 0,
      "df": 0,
      "dr": 0,
      "ft": 0,
      "pf": 0,
      "pr": 0,
      "rt": 0,
      "locked": 1,
      "fd_window": 0,
      "fp_window": 0,
      "rd_window": 0,
      "rp_window": 0,
      "sentry_mode": 0,
      "valet_mode": 0
    },
    {
      "id": 9271668763,
      "timestamp": 1644010160,
      "state": "online",
      "charging_state": "Charging",
      "shift_state": "P",
      "version": "2022.4",
      "battery_level": 88,
      "usable_battery_level": 88,
      "battery_range": 266.69,
      "est_battery_range": 221.31,
      "ideal_battery_range": 999,
      "latitude": 40.7484,
      "longitude": 73.9857,
      "elevation": null,
      "heading": 213,
      "speed": null,
      "power": 0,
      "odometer": 14096.5,
      "charge_rate": 1,
      "charger_actual_current": 12,
      "charger_power": 1,
      "charger_phases": 1,
      "charger_voltage": 119,
      "charge_miles_added_rated": 1.5,
      "charge_miles_added_ideal": 422,
      "is_climate_on": 0,
      "is_preconditioning": 0,
      "battery_heater_on": 0,
      "inside_temp": 37.8,
      "outside_temp": 20.5,
      "left_temp_direction": 0,
      "right_temp_direction": 0,
      "df": 0,
      "dr": 0,
      "ft": 0,
      "pf": 0,
      "pr": 0,
      "rt": 0,
      "locked": 1,
      "fd_window": 0,
      "fp_window": 0,
      "rd_window": 0,
      "rp_window": 0,
      "sentry_mode": 0,
      "valet_mode": 0
    },
    {
      "id": 9271676809,
      "timestamp": 1644010170,
      "state": "online",
      "charging_state": "Charging",
      "shift_state": "P",
      "version": "2022.4",
      "battery_level": 88,
      "usable_battery_level": 88,
      "battery_range": 266.69,
      "est_battery_range": 221.31,
      "ideal_battery_range": 999,
      "latitude": 40.7484,
      "longitude": 73.9857,
      "elevation": null,
      "heading": 213,
      "speed": null,
      "power": 0,
      "odometer": 14096.5,
      "charge_rate": 1,
      "charger_actual_current": 12,
      "charger_power": 1,
      "charger_phases": 1,
      "charger_voltage": 118,
      "charge_miles_added_rated": 1.5,
      "charge_miles_added_ideal": 422,
      "is_climate_on": 0,
      "is_preconditioning": 0,
      "battery_heater_on": 0,
      "inside_temp": 37.7,
      "outside_temp": 20.5,
      "left_temp_direction": 0,
      "right_temp_direction": 0,
      "df": 0,
      "dr": 0,
      "ft": 0,
      "pf": 0,
      "pr": 0,
      "rt": 0,
      "locked": 1,
      "fd_window": 0,
      "fp_window": 0,
      "rd_window": 0,
      "rp_window": 0,
      "sentry_mode": 0,
      "valet_mode": 0
    }
  ]
}

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

​
from
number

The start of the timeframe. Unix timestamp in seconds.

​
to
number

The end of the timeframe. Unix timestamp in seconds.

​
interval
number

The desired number of seconds between data points. Set to 1 to return all data points.

Example:

1

​
condense
boolean
default:false

Whether to condense data output.

​
timezone
string
default:UTC

The IANA timezone name.

​
distance_format
enum<string>
default:mi

Whether to return data in miles or kilometers.

Available options:
mi,
km
​
temperature_format
enum<string>
default:c

Whether to return data in Fahrenheit or Celsius.

Available options:
c,
f
​
format
enum<string>
default:json

Whether to output the results in JSON or CSV.

Available options:
json,
csv

Response

200 - application/json

Success

  • Option 1
  • Option 2
​
results
Historical State · object[]
⌘I