# Overview
Source: https://developer.tessie.com/reference/about
About our platform
Tessie is a management platform for Tesla drivers and fleet managers, providing apps, analytics, automations, integrations and APIs for Tesla vehicles and energy products.
We provide access to [Tesla Fleet API](/reference/access-tesla-fleet-api), [Tesla Fleet Telemetry](/reference/access-tesla-fleet-telemetry) and [our own API](/reference/tesla-api-comparison).
# Access Tesla Fleet API
Source: https://developer.tessie.com/reference/access-tesla-fleet-api
Fleet API is the official API for interacting with Tesla vehicles and energy products
Tessie provides full access to Tesla Fleet API. We've also built in significant improvements:
* Get instant access to Tesla Fleet API without an extremely complex and lengthy setup process
* Save up to 99% off your Tesla Fleet API bill with unlimited and free vehicle data polling
* Drop-in replacement for developers migrating existing applications from existing Tesla APIs
* Use a simple API key instead of building complex OAuth systems
* Automatic routing between North America, Europe and China Fleet API regions
* Automatic Vehicle Command Protocol command signing
## Get started
Simply point any Fleet API request at `api.tessie.com`.
Provide your access token in an Authorization header or as the access\_token query parameter. [Learn more.](/reference/authentication)
Visit the [Tesla Fleet API Reference](https://developer.tesla.com/docs/fleet-api) to see all endpoints.
### Example Fleet API requests
<CodeGroup>
```bash bash theme={null}
curl -H "Authorization: <ROTATING_TESLA_OAUTH_ACCESS_TOKEN>" \
https://fleet-api.prd.na.vn.cloud.tesla.com/api/1/vehicles
curl -H "Authorization: <ROTATING_TESLA_OAUTH_ACCESS_TOKEN>" \
https://fleet-api.prd.eu.vn.cloud.tesla.com/api/1/vehicles
curl -H "Authorization: <ROTATING_TESLA_OAUTH_ACCESS_TOKEN>" \
https://fleet-api.prd.cn.vn.cloud.tesla.cn/api/1/vehicles
```
</CodeGroup>
### Example drop-in replacement
<CodeGroup>
```bash bash theme={null}
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
https://api.tessie.com/api/1/vehicles
```
</CodeGroup>
# Access Tesla Fleet Telemetry
Source: https://developer.tessie.com/reference/access-tesla-fleet-telemetry
Fleet Telemetry is an end-to-end encrypted telemetry data stream generated by your vehicle
Tessie provides full access to Tesla Fleet Telemetry. We've also built in significant improvements:
* Get instant access to Tesla Fleet Telemetry without an extremely complex and lengthy setup process
* Just connect to your dedicated streaming endpoint and you're done; no servers or hosting required
## Requirements
See [this page](https://help.tessie.com/article/128-direct-telemetry) for the latest vehicle requirements.
## Get started
Using any WebSocket client, connect to: `streaming.tessie.com/YOUR_VIN`
Provide your access token in an Authorization header or as the access\_token query parameter. [Learn more.](/reference/authentication)
Visit [streaming.tessie.com/explorer](https://streaming.tessie.com/explorer) for an example implementation. Check the page source code.
## Data structure
All messages are formatted in JSON.
### Example data message
Visit [this data file](https://github.com/teslamotors/fleet-telemetry/blob/main/protos/vehicle_data.proto) to see all possible data points.
```
{
"data": [
{
"key": "IdealBatteryRange",
"value": {
"stringValue": "171.833"
}
},
{
"key": "ModuleTempMax",
"value": {
"stringValue": "41.500"
}
},
{
"key": "EnergyRemaining",
"value": {
"stringValue": "42.880"
}
},
{
"key": "Location",
"value": {
"locationValue": {,
"latitude": 37.4925352,
"longitude": -121.9447469
}
}
},
{
"key": "PackVoltage",
"value": {
"stringValue": "367.950"
}
},
{
"key": "ACChargingPower",
"value": {
"stringValue": "0.000"
}
},
{
"key": "Odometer",
"value": {
"stringValue": "11270.940"
}
},
{
"key": "PackCurrent",
"value": {
"stringValue": "-0.600"
}
},
{
"key": "GpsHeading",
"value": {
"stringValue": "81.639"
}
},
{
"key": "ACChargingEnergyIn",
"value": {
"stringValue": "17.260"
}
},
{
"key": "RatedRange",
"value": {
"stringValue": "171.833"
}
},
{
"key": "ChargeAmps",
"value": {
"stringValue": "48"
}
},
{
"key": "EstBatteryRange",
"value": {
"stringValue": "131.519"
}
},
{
"key": "ModuleTempMin",
"value": {
"stringValue": "41.000"
}
},
{
"key": "LifetimeEnergyUsed",
"value": {
"stringValue": "5567.591"
}
},
{
"key": "Soc",
"value": {
"stringValue": "54.987"
}
}
],
"createdAt": "2024-08-01T00:44:39.138713677Z",
"vin": "LRW3F7FR9NC123456"
}
```
### Example alerts message
Visit [stats.tessie.com/alerts](https://stats.tessie.com/alerts) to see all possible alert codes and their impact.
```
{
"alerts": [
{
"name": "VCFRONT_a361_washerFluidLowMomentary",
"audiences": [
"Service",
"Customer"
],
"startedAt": "2024-08-01T00:21:41.545Z",
"endedAt": "2024-08-01T00:21:49.543Z"
},
{
"name": "APP_w269_autopilotLimited",
"audiences": [
"Customer",
"Service"
],
"startedAt": "2024-08-01T00:15:08.542Z",
"endedAt": "2024-08-01T00:15:14.544Z"
}
],
"createdAt": "2024-08-01T00:44:32.558510331Z",
"vin": "LRW3F7FR9NC123456"
}
```
### Example connectivity message
```
{
"vin": "LRW3F7FR9NC123456",
"connectionId": "913a422e-7169-48fa-a4a4-2eab9f12ab34",
"status": "DISCONNECTED",
"createdAt": "2024-10-29T21:56:14.764032001Z"
}
```
### Example errors message
```
{
"errors": [
{
"createdAt": "2024-08-01T00:44:06.780721459Z",
"name": "unsupported_field",
"tags": {
"field_name": "LifetimeEnergyGainedRegen",
"name": "1bfd3e4b3966-496c-b87a-59999f71234"
},
"body": ""
}
],
"createdAt": "2024-08-01T00:44:06.780721459Z",
"vin": "LRW3F7FR9NC123456"
}
```
# Add Charge Schedule
Source: https://developer.tessie.com/reference/add-charge-schedule
post /{vin}/command/add_charge_schedule
Add or update a charging schedule.
# Add Precondition Schedule
Source: https://developer.tessie.com/reference/add-precondition-schedule
post /{vin}/command/add_precondition_schedule
Add or update a preconditioning schedule.
# Authentication
Source: https://developer.tessie.com/reference/authentication
One simple token that works everywhere
## Create a token
Visit [developer settings](https://dash.tessie.com/settings/api) and select *Generate Access Token*.
## Use your token
### In a header
The recommended and most secure method is to pass your token in a header:
`Authorization: Bearer YOUR_TOKEN`
### In the URL
For easy debugging and specific applications, it can be helpful to pass your token as the access\_token query parameter instead.
<Warning>
Do not pass your access token in the URL on insecure networks or behind VPNs where traffic logs could potentially be snooped.
</Warning>
## Examples
You can use all APIs using a single Tessie access token:
### Tesla Fleet API
`https://api.tessie.com/api/1/vehicles?access_token=YOUR_TOKEN`
### Tesla Fleet Telemetry
`wss://streaming.tessie.com/YOUR_VIN?access_token=YOUR_TOKEN`
### Tessie API
`https://api.tessie.com/vehicles?access_token=YOUR_TOKEN`
# Boombox
Source: https://developer.tessie.com/reference/boombox
post /{vin}/command/remote_boombox
Generates a fart sound.
Requires 2022.40.25+.
# Cancel Software Update
Source: https://developer.tessie.com/reference/cancel-software-update
post /{vin}/command/cancel_software_update
Cancels any scheduled software update.
# Clear Speed Limit PIN
Source: https://developer.tessie.com/reference/clear-speed-limit-pin
post /{vin}/command/clear_speed_limit_pin
Removes the speed limit PIN.
# Close Charge Port
Source: https://developer.tessie.com/reference/close-charge-port
post /{vin}/command/close_charge_port
Closes the charge port.
# Close Sunroof
Source: https://developer.tessie.com/reference/close-sunroof
post /{vin}/command/close_sunroof
Closes the sunroof.
# Close Tonneau
Source: https://developer.tessie.com/reference/close-tonneau
post /{vin}/command/close_tonneau
Closes the tonneau.
# Close Windows
Source: https://developer.tessie.com/reference/close-windows
post /{vin}/command/close_windows
Closes all windows, if the vehicle supports it.
# Create an Invitation
Source: https://developer.tessie.com/reference/create-an-invitation
post /{vin}/invitations
Creates a driver invitation.
# Delete Driver
Source: https://developer.tessie.com/reference/delete-driver
post /{vin}/drivers/{id}/delete
Deletes a driver from the vehicle.
# Delete Telemetry Config
Source: https://developer.tessie.com/reference/delete-telemetry-config
delete /{vin}/fleet_telemetry_config
Delete the vehicle's Fleet Telemetry configuration.
**Important:** Deleting this configuration will disable Tessie platform functionality.
# Disable Guest Mode
Source: https://developer.tessie.com/reference/disable-guest-mode
post /{vin}/command/disable_guest
Disables Guest Mode.
# Disable Sentry Mode
Source: https://developer.tessie.com/reference/disable-sentry-mode
post /{vin}/command/disable_sentry
Disables Sentry Mode.
# Disable Speed Limit
Source: https://developer.tessie.com/reference/disable-speed-limit
post /{vin}/command/disable_speed_limit
Disables the speed limit.
# Disable Valet Mode
Source: https://developer.tessie.com/reference/disable-valet-mode
post /{vin}/command/disable_valet
Disables Valet Mode.
# Enable Guest Mode
Source: https://developer.tessie.com/reference/enable-guest-mode
post /{vin}/command/enable_guest
Enables Guest Mode.
# Enable Keyless Driving
Source: https://developer.tessie.com/reference/enable-keyless-driving
post /{vin}/command/remote_start
Enables keyless driving.
Driving must begin within 2 minutes.
# Enable Sentry Mode
Source: https://developer.tessie.com/reference/enable-sentry-mode
post /{vin}/command/enable_sentry
Enables Sentry Mode.
# Enable Speed Limit
Source: https://developer.tessie.com/reference/enable-speed-limit
post /{vin}/command/enable_speed_limit
Activates the speed limit.
# Enable Valet Mode
Source: https://developer.tessie.com/reference/enable-valet-mode
post /{vin}/command/enable_valet
Enables Valet Mode.
# Flash Lights
Source: https://developer.tessie.com/reference/flash-lights
post /{vin}/command/flash
Flashes the lights.
# Front Trunk
Source: https://developer.tessie.com/reference/front-trunk
post /{vin}/command/activate_front_trunk
Opens the front trunk.
# Get All Charging Invoices
Source: https://developer.tessie.com/reference/get-all-charging-invoices
get /charging_invoices
Returns charging invoices for all vehicles.
For fleet accounts only.
# Get Vehicles
Source: https://developer.tessie.com/reference/get-all-vehicles
get /vehicles
Returns the latest state of all vehicles.
# Get Battery
Source: https://developer.tessie.com/reference/get-battery
get /{vin}/battery
Returns the state of a vehicle's battery.
# Get Battery Health
Source: https://developer.tessie.com/reference/get-battery-health
get /battery_health
Returns the battery health of all vehicles.
# Get Battery Health Measurements
Source: https://developer.tessie.com/reference/get-battery-health-measurements
get /{vin}/battery_health
Returns the battery health measurements for a vehicle over time.
# Get Charges
Source: https://developer.tessie.com/reference/get-charges
get /{vin}/charges
Returns the charges for a vehicle.
# Get Consumption
Source: https://developer.tessie.com/reference/get-consumption
get /{vin}/consumption_since_charge
Returns consumption data since a vehicle was last charged.
# Get Drivers
Source: https://developer.tessie.com/reference/get-drivers
get /{vin}/drivers
Returns a list of additional drivers.
# Get Drives
Source: https://developer.tessie.com/reference/get-drives
get /{vin}/drives
Returns the drives for a vehicle.
# Get Driving Path
Source: https://developer.tessie.com/reference/get-driving-path
get /{vin}/path
Returns the driving path of a vehicle during a given timeframe.
If no timeframe is specified, returns the driving path for the last 30 days.
# Get Firmware Alerts
Source: https://developer.tessie.com/reference/get-firmware-alerts
get /{vin}/firmware_alerts
Returns the list of firmware alerts generated by a vehicle.
# Get Historical States
Source: https://developer.tessie.com/reference/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.
# Get Idles
Source: https://developer.tessie.com/reference/get-idles
get /{vin}/idles
Returns the idles for a vehicle.
A vehicle is considered idle if not driving or charging.
# Get Invitations
Source: https://developer.tessie.com/reference/get-invitations
get /{vin}/invitations
Returns a list of driver invitations.
# Get Last Idle State
Source: https://developer.tessie.com/reference/get-last-idle-state
get /{vin}/last_idle_state
Returns data associated with when a vehicle last stopped driving or charging.
# Get License Plate
Source: https://developer.tessie.com/reference/get-license-plate
get /{vin}/plate
Returns the license plate of the vehicle.
# Get Location
Source: https://developer.tessie.com/reference/get-location
get /{vin}/location
Returns the coordinates, street address and associated saved location of a vehicle.
# Get Map
Source: https://developer.tessie.com/reference/get-map
get /{vin}/map
Returns a map image of a vehicle's location.
# Get Status
Source: https://developer.tessie.com/reference/get-status
get /{vin}/status
Returns the status of a vehicle.
The status may be `asleep`, `waiting_for_sleep` or `awake`.
# Get Telemetry Config
Source: https://developer.tessie.com/reference/get-telemetry-config
get /{vin}/fleet_telemetry_config
Returns the vehicle's Fleet Telemetry configuration.
# Get Tire Pressure
Source: https://developer.tessie.com/reference/get-tire-pressure
get /{vin}/tire_pressure
Returns the tire pressure of a vehicle, measured in bar.
Requires firmware 2022.4.5+.
# Get Vehicle
Source: https://developer.tessie.com/reference/get-vehicle
get /{vin}/state
Returns the latest state of a vehicle.
# Get Weather
Source: https://developer.tessie.com/reference/get-weather
get /{vin}/weather
Returns the weather forecast around a vehicle.
# Honk
Source: https://developer.tessie.com/reference/honk
post /{vin}/command/honk
Honks the horn.
# Lock
Source: https://developer.tessie.com/reference/lock
post /{vin}/command/lock
Locks the vehicle.
# Open Charge Port
Source: https://developer.tessie.com/reference/open-charge-port
post /{vin}/command/open_charge_port
Opens the charge port if it's closed, or unlocks it if it's open.
# Open Tonneau
Source: https://developer.tessie.com/reference/open-tonneau
post /{vin}/command/open_tonneau
Opens the tonneau.
# Quick Start
Source: https://developer.tessie.com/reference/quick-start
Get data or control your vehicle in seconds
1. Visit [developer settings](https://dash.tessie.com/settings/api) and select *Generate Access Token*
2. Visit any of these examples to get data or control your vehicle:
<CodeGroup>
```bash Get data theme={null}
https://api.tessie.com/vehicles?access_token=YOUR_TOKEN
```
```bash Honk theme={null}
https://api.tessie.com/YOUR_VIN/command/honk?access_token=YOUR_TOKEN
```
```bash Start climate theme={null}
https://api.tessie.com/YOUR_VIN/command/start_climate?access_token=YOUR_TOKEN
```
```bash Stop climate theme={null}
https://api.tessie.com/YOUR_VIN/command/stop_climate?access_token=YOUR_TOKEN
```
</CodeGroup>
Yes, it's that easy.
# Rear Trunk
Source: https://developer.tessie.com/reference/rear-trunk
post /{vin}/command/activate_rear_trunk
Opens the rear trunk, or closes it if the trunk is open and the vehicle has a powered trunk.
# Remove Charge Schedule
Source: https://developer.tessie.com/reference/remove-charge-schedule
post /{vin}/command/remove_charge_schedule
Remove a charging schedule.
# Remove Precondition Schedule
Source: https://developer.tessie.com/reference/remove-precondition-schedule
post /{vin}/command/remove_precondition_schedule
Remove a preconditioning schedule.
# Revoke an Invitation
Source: https://developer.tessie.com/reference/revoke-an-invitation
post /{vin}/invitations/{id}/revoke
Revokes a driver invitation.
# Schedule Software Update
Source: https://developer.tessie.com/reference/schedule-software-update
post /{vin}/command/schedule_software_update
Schedules a software update.
# Set Bio Defense Mode
Source: https://developer.tessie.com/reference/set-bio-defense-mode
post /{vin}/command/set_bioweapon_mode
Sets Bioweapon Defense Mode.
# Set Cabin Overheat Protection
Source: https://developer.tessie.com/reference/set-cabin-overheat-protection
post /{vin}/command/set_cabin_overheat_protection
Sets the Cabin Overheat Protection mode.
# Set Cabin Overheat Protection Temp
Source: https://developer.tessie.com/reference/set-cabin-overheat-protection-temp
post /{vin}/command/set_cop_temp
Sets the Cabin Overheat Protection activation temperature.
# Set Charge Cost
Source: https://developer.tessie.com/reference/set-charge-cost
post /{vin}/charges/{id}/set_cost
Sets the cost of a charge.
# Set Charge Limit
Source: https://developer.tessie.com/reference/set-charge-limit
post /{vin}/command/set_charge_limit
Sets the charge limit.
# Set Charging Amps
Source: https://developer.tessie.com/reference/set-charging-amps
post /{vin}/command/set_charging_amps
Sets the charging amps.
# Set Climate Keeper Mode
Source: https://developer.tessie.com/reference/set-climate-keeper-mode
post /{vin}/command/set_climate_keeper_mode
Sets the Climate Keeper mode.
# Set Drive Tag
Source: https://developer.tessie.com/reference/set-drive-tag
post /{vin}/drives/set_tag
Sets the tag for a list of drives.
# Set License Plate
Source: https://developer.tessie.com/reference/set-license-plate
post /{vin}/plate
Sets the license plate for the vehicle.
# Set Scheduled Charging
Source: https://developer.tessie.com/reference/set-scheduled-charging
post /{vin}/command/set_scheduled_charging
Sets the scheduled charging configuration.
For vehicles on 2024.26+, use [add_charge_schedule](https://developer.tessie.com/reference/add-charge-schedule) and [add_precondition_schedule](https://developer.tessie.com/reference/remove-charge-schedule) instead.
# Set Scheduled Departure
Source: https://developer.tessie.com/reference/set-scheduled-departure
post /{vin}/command/set_scheduled_departure
Sets the scheduled departure configuration.
For vehicles on 2024.26+, use [add_charge_schedule](https://developer.tessie.com/reference/add-charge-schedule) and [add_precondition_schedule](https://developer.tessie.com/reference/remove-charge-schedule) instead.
# Set Seat Cooling
Source: https://developer.tessie.com/reference/set-seat-cooling
post /{vin}/command/set_seat_cool
Sets the seat cooling level.
# Set Seat Heating
Source: https://developer.tessie.com/reference/set-seat-heating
post /{vin}/command/set_seat_heat
Sets the seat heating level.
# Set Speed Limit
Source: https://developer.tessie.com/reference/set-speed-limit
post /{vin}/command/set_speed_limit
Sets the speed limit.
# Set Telemetry Config
Source: https://developer.tessie.com/reference/set-telemetry-config
post /{vin}/fleet_telemetry_config
Sets the vehicle's Fleet Telemetry configuration.
By default, sets our recommended configuration. Specify a configuration to overwrite it. Custom configurations are limited to a maximum rate of 1 signal per second.
The complete list of fields can be found [here](https://github.com/teslamotors/fleet-telemetry/blob/main/protos/vehicle_data.proto).
**Important:** Modifying this configuration may have adverse effects on Tessie platform functionality.
# Set Temperature
Source: https://developer.tessie.com/reference/set-temperature
post /{vin}/command/set_temperatures
Sets the cabin temperature.
# Share
Source: https://developer.tessie.com/reference/share
post /{vin}/command/share
Shares an address, latitude/longitude or video URL to the vehicle.
# Start Charging
Source: https://developer.tessie.com/reference/start-charging
post /{vin}/command/start_charging
Starts charging.
# Start Climate
Source: https://developer.tessie.com/reference/start-climate
post /{vin}/command/start_climate
Starts the climate system and preconditions the battery.
# Start Defrost
Source: https://developer.tessie.com/reference/start-defrost
post /{vin}/command/start_max_defrost
Starts defrosting.
# Start Steering Wheel Heater
Source: https://developer.tessie.com/reference/start-steering-wheel-heater
post /{vin}/command/start_steering_wheel_heater
Starts the steering wheel heater.
# Stop Charging
Source: https://developer.tessie.com/reference/stop-charging
post /{vin}/command/stop_charging
Stops charging.
# Stop Climate
Source: https://developer.tessie.com/reference/stop-climate
post /{vin}/command/stop_climate
Stops the climate system.
# Stop Defrost
Source: https://developer.tessie.com/reference/stop-defrost
post /{vin}/command/stop_max_defrost
Stops defrosting.
# Stop Steering Wheel Heater
Source: https://developer.tessie.com/reference/stop-steering-wheel-heater
post /{vin}/command/stop_steering_wheel_heater
Stops the steering wheel heater.
# Compare APIs
Source: https://developer.tessie.com/reference/tesla-api-comparison
Choose from three APIs depending on how you want to integrate
* Our [Tesla Fleet API layer](https://developer.tessie.com/reference/access-tesla-fleet-api) allows you to instantly access Tesla Fleet API without any prior registration or setup. It includes many enhancements on top of Fleet API, like unlimited vehicle\_data polling at no additional cost, streamlined authorization and automatic Vehicle Command Protocol signing. This is recommended for developers migrating existing applications from the Tesla Owner API or Tesla Fleet API.
* Our [Tesla Fleet Telemetry streaming API](https://developer.tessie.com/reference/access-tesla-fleet-telemetry) allows you to stream data directly from your vehicle without setting up your own Fleet Telemetry domain and servers.
* The Tessie API (represented by the endpoints listed on this site) is built on our Tesla Fleet API layer, but includes many additional data endpoints and further enhancements to vehicle controls, like automatic wakes and automatic firmware error handling. This is recommended for most developers starting something new.
You can mix and match all three as you need using a single Tessie access token. No fuss; it just works.
# Trigger HomeLink
Source: https://developer.tessie.com/reference/trigger-homelink
post /{vin}/command/trigger_homelink
Triggers the primary HomeLink device.
# Unlock
Source: https://developer.tessie.com/reference/unlock
post /{vin}/command/unlock
Unlocks the vehicle.
# Vent Sunroof
Source: https://developer.tessie.com/reference/vent-sunroof
post /{vin}/command/vent_sunroof
Vents the sunroof.
# Vent Windows
Source: https://developer.tessie.com/reference/vent-windows
post /{vin}/command/vent_windows
Vents all windows.
# Wake
Source: https://developer.tessie.com/reference/wake
post /{vin}/wake
Wakes the vehicle from sleep.
Returns true after the vehicle is awake, or false after a 90-second timeout.
