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

# Get Historical States

`GET /{vin}/states`

Returns historical states for a vehicle during a timeframe.

If no interval is specified, a sensible interval based on the timeframe is used.

## Path parameters

- `vin` string, required

## Query parameters

- `from` number
- `to` number
- `interval` number
- `condense` boolean
- `timezone` string
- `distance_format` 'mi' | 'km'
- `temperature_format` 'c' | 'f'
- `format` 'json' | 'csv'

## Response `200`

Success

- union
  - object
    - `results` HistoryState[]
      - `id` number
      - `timestamp` number
      - `state` string, nullable
      - `charging_state` string, nullable
      - `shift_state` string, nullable
      - `battery_level` number, nullable
      - `usable_battery_level` number, nullable
      - `battery_range` number, nullable
      - `ideal_battery_range` number, nullable
      - `latitude` number, nullable
      - `longitude` number, nullable
      - `elevation` number, nullable
      - `speed` number, nullable
      - `power` number, nullable
      - `odometer` number, nullable
      - `charge_rate` number, nullable
      - `charger_actual_current` number, nullable
      - `charger_power` number, nullable
      - `charger_phases` number, nullable
      - `charger_voltage` number, nullable
      - `charge_energy_added` number, nullable
      - `charge_miles_added_rated` number, nullable
      - `charge_miles_added_ideal` number, nullable
      - `is_climate_on` number, nullable
      - `battery_heater_on` number, nullable
      - `inside_temp` number, nullable
      - `outside_temp` number, nullable
      - `locked` number, nullable
      - `sentry_mode` number, nullable
      - `lifetime_energy_used` number, nullable
      - `energy_remaining` number, nullable
      - `pack_current` number, nullable
      - `pack_voltage` number, nullable
      - `module_temp_min` number, nullable
      - `module_temp_max` number, nullable
  - object
    - `results` CondensedHistoryStates — The historical states of a vehicle in a condensed format.
      - `ids` number[]
      - `timestamps` number[]
      - `states` string[]
      - `charging_states` string[]
      - `shift_states` string[]
      - `battery_levels` number[]
      - `usable_battery_levels` number[]
      - `battery_ranges` number[]
      - `ideal_battery_ranges` number[]
      - `latitudes` number[]
      - `longitudes` number[]
      - `elevations` number[]
      - `speeds` number[]
      - `powers` number[]
      - `odometers` number[]
      - `charge_rates` number[]
      - `charger_actual_currents` number[]
      - `charger_powers` number[]
      - `charger_phasess` number[]
      - `charger_voltages` number[]
      - `charge_energy_addeds` number[]
      - `charge_miles_added_rateds` number[]
      - `charge_miles_added_ideals` number[]
      - `is_climate_ons` number[]
      - `battery_heater_ons` number[]
      - `inside_temps` number[]
      - `outside_temps` number[]
      - `lockeds` number[]
      - `sentry_modes` number[]
      - `lifetime_energy_used` number[]
      - `energy_remaining` number[]
      - `pack_current` number[]
      - `pack_voltage` number[]
      - `module_temp_min` number[]
      - `module_temp_max` number[]

---

[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)