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": 1644010150,
      "timestamp": 1644010150,
      "state": "online",
      "charging_state": "Charging",
      "shift_state": "P",
      "battery_level": 88,
      "usable_battery_level": 88,
      "battery_range": 266.69,
      "ideal_battery_range": 999,
      "latitude": 40.7484,
      "longitude": 73.9857,
      "elevation": null,
      "speed": null,
      "power": null,
      "odometer": 14096.5,
      "charge_rate": 2,
      "charger_actual_current": 12,
      "charger_power": 1,
      "charger_phases": 1,
      "charger_voltage": 118,
      "charge_energy_added": 4.64,
      "charge_miles_added_rated": 1.5,
      "charge_miles_added_ideal": 422,
      "is_climate_on": 0,
      "battery_heater_on": 0,
      "inside_temp": 37.7,
      "outside_temp": 20.5,
      "locked": 1,
      "sentry_mode": 0,
      "lifetime_energy_used": 5224.71,
      "energy_remaining": 51.26,
      "pack_current": -0.7,
      "pack_voltage": 419.79,
      "module_temp_min": 25.5,
      "module_temp_max": 26
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developer.tessie.com/llms.txt

Use this file to discover all available pages before exploring further.

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:true

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

​
results
Historical State · object[]