GET
/
{vin}
/
charges
Get Charges
curl --request GET \
  --url https://api.tessie.com/{vin}/charges \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "id": 434159,
      "started_at": 1628906796,
      "ended_at": 1628911246,
      "location": "South Las Vegas Boulevard, Las Vegas, Nevada 89119, United States",
      "latitude": 36.070656,
      "longitude": -115.172968,
      "is_supercharger": true,
      "odometer": 12345.67,
      "energy_added": 81.41,
      "energy_used": 81.5,
      "miles_added": 256,
      "miles_added_ideal": 512,
      "starting_battery": 11,
      "ending_battery": 96,
      "cost": 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

​
distance_format
enum<string>
default:mi

Whether to return data in miles or kilometers.

Available options:
mi,
km
​
format
enum<string>
default:json

Whether to output the results in JSON or CSV.

Available options:
json,
csv
​
superchargers_only
boolean
default:false

Whether to only include charges from Superchargers.

​
origin_latitude
number

The latitude of the charging station.

Example:

37.4925

​
origin_longitude
number

The longitude of the charging station.

Example:

121.9447

​
origin_radius
number

The radius from the charging station, in meters.

Example:

80

​
exclude_origin
boolean
default:false

Whether to exclude the charging station.

​
timezone
string
default:UTC

The IANA timezone name.

​
from
number

The start of the timeframe. Unix timestamp in seconds.

​
to
number

The end of the timeframe. Unix timestamp in seconds.

​
minimum_energy_added
number

The minimum energy added to the battery, in kWh.

Example:

1

​
limit
number

The maximum number of results.

Response

200 - application/json

Success