Tesla Motors

opencollection: 1.0.0
info:
  name: Tesla Motors Owner API
  version: '1.0'
items:
- info:
    name: Authentication
    type: folder
  items:
  - info:
      name: Tesla Get an Access Token
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/oauth/token
      body:
        type: json
        data: '{}'
    docs: 'Performs the login. Takes in an plain text email and password, matching the owner''s login information for [https://my.teslamotors.com/user/login](https://my.teslamotors.com/user/login).

      Returns a `access_token` which is passed along as a header with all future requests to authenticate the user.

      You must provide the `Authorization: Bearer {access_token}` header in all other requests.

      The current client ID and secret are [available here](http://pastebin.com/YiLPDggh)'
- info:
    name: Vehicles
    type: folder
  items:
  - info:
      name: Tesla List all Vehicles
      type: http
    http:
      method: GET
      url: https://owner-api.teslamotors.com/api/1/vehicles
    docs: Retrieve a list of your owned vehicles (includes vehicles not yet shipped!)
  - info:
      name: Tesla Retrieve a vehicle
      type: http
    http:
      method: GET
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Retrieve a specific vehicle
  - info:
      name: Tesla Mobile Access
      type: http
    http:
      method: GET
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/mobile_enabled
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Determines if mobile access to the vehicle is enabled.
  - info:
      name: Tesla Charge State
      type: http
    http:
      method: GET
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/data_request/charge_state
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Returns the state of charge in the battery.
  - info:
      name: Tesla Climate Settings
      type: http
    http:
      method: GET
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/data_request/climate_state
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Returns the current temperature and climate control state.
  - info:
      name: Tesla Driving and Position
      type: http
    http:
      method: GET
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/data_request/drive_state
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Returns the driving and position state of the vehicle.
  - info:
      name: Tesla GUI Settings
      type: http
    http:
      method: GET
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/data_request/gui_settings
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Returns various information about the GUI settings of the car, such as unit format and range display.
  - info:
      name: Tesla Vehicle State
      type: http
    http:
      method: GET
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/data_request/vehicle_state
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Returns the vehicle's physical state, such as which doors are open.
  - info:
      name: Tesla Vehicle Config
      type: http
    http:
      method: GET
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/data_request/vehicle_config
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Returns the vehicle's configuration
  - info:
      name: Tesla Vehicle Data
      type: http
    http:
      method: GET
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/vehicle_data
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      - name: endpoints
        value: ''
        type: query
    docs: Returns all vehicle ∂ata, potentially cached
  - info:
      name: Tesla Get Nearby Chargers
      type: http
    http:
      method: GET
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/nearby_charging_sites
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Get a list of nearby charging sites
- info:
    name: Vehicle Commands
    type: folder
  items:
  - info:
      name: Tesla Wake Up Car
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/wake_up
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Wakes up the car from the sleep state. Necessary to get some data from the car.
  - info:
      name: Tesla Wake Up Car
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/wake_up
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Wakes up the car from the sleep state. Necessary to get some data from the car.
  - info:
      name: Tesla Set Valet Mode
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/set_valet_mode
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: 'Sets valet mode on or off with a PIN to disable it from within the car. Reuses last PIN from previous valet session.

      Valet Mode limits the car''s top speed to 70MPH and 80kW of acceleration power. It also disables Homelink, Bluetooth
      and

      Wifi settings, and the ability to disable mobile access to the car. It also hides your favorites, home, and work

      locations in navigation.'
  - info:
      name: Tesla Reset Valet PIN
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/reset_valet_pin
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Resets the PIN set for valet mode, if set.
  - info:
      name: Tesla Open Charge Port
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/charge_port_door_open
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Opens and unlocks the charge port.
  - info:
      name: Tesla Close Charge Port
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/charge_port_door_close
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Closes the charge port.
  - info:
      name: Tesla Set Charge Limit to Standard
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/charge_standard
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Set the charge mode to standard (90% under the new percentage system introduced in 4.5).
  - info:
      name: Tesla Set Charge Limit to Max Range
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/charge_max_range
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Set the charge mode to max range (100% under the new percentage system introduced in 4.5). Use sparingly!
  - info:
      name: Tesla Set Charge Limit
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/set_charge_limit
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Set the charge limit to a custom percentage.
  - info:
      name: Tesla Set Charge Current
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/set_charging_amps
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Set the maximum Charge Current in Amps
  - info:
      name: Tesla Set Scheduled Departure
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/set_scheduled_departure
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Set Scheduled Departure settings
  - info:
      name: Tesla Set Scheduled Charging
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/set_scheduled_charging
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Set Scheduled Charging settings
  - info:
      name: Tesla Start Charging
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/charge_start
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Start charging. Must be plugged in, have power available, and not have reached your charge limit.
  - info:
      name: Tesla Stop Charging
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/charge_stop
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Stop charging. Must already be charging.
  - info:
      name: Tesla Flash Lights
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/flash_lights
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Flash the lights once.
  - info:
      name: Tesla Honk Horn
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/honk_horn
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Honk the horn once.
  - info:
      name: Tesla Unlock Doors
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/door_unlock
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Unlock the car's doors.
  - info:
      name: Tesla Lock Doors
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/door_lock
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Lock the car's doors.
  - info:
      name: Tesla Set Temperature
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/set_temps
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Set the temperature target for the HVAC system.
  - info:
      name: Tesla Start HVAC System
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/auto_conditioning_start
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Start the climate control system. Will cool or heat automatically, depending on set temperature.
  - info:
      name: Tesla Stop HVAC System
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/auto_conditioning_stop
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Stop the climate control system.
  - info:
      name: Tesla Toggle Bioweapon Defense Mode
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/set_bioweapon_mode
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Enable or Disable Bioweapon Defense Mode on equipped vehicles.
  - info:
      name: Tesla Set the Climate Keeper mode
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/set_climate_keeper_mode
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Set the Climate Keeper mode.
  - info:
      name: Tesla Enable or Disable Cabin Overheat Protection
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/set_cabin_overheat_protection
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Enable or Disable Cabin Overheat Protection
  - info:
      name: Tesla Set Seat Heater Level
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/remote_seat_heater_request
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Set the heating level of a seat heater
  - info:
      name: Tesla Set Seat Cooler Level
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/remote_seat_cooler_request
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Set the cooling level of a seat heater
  - info:
      name: Tesla Toggle Automatic Seat Heater/Cooler
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/remote_auto_seat_climate_request
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Enables or disables automatic control of a seat heater/coooler
  - info:
      name: Tesla Toggle Steering Wheel Heater
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/remote_steering_wheel_heater_request
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Toggle the steering wheel heater
  - info:
      name: Tesla Move Pano Roof
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/sun_roof_control
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Controls the car's panoramic roof, if installed.
  - info:
      name: Tesla Remote Start
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/remote_start_drive
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Start the car for keyless driving. Must start driving within 2 minutes of issuing this request.
  - info:
      name: Tesla Open Trunk/Frunk
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/actuate_trunk
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Open the trunk or frunk. Currently inoperable.
  - info:
      name: Tesla Activate Speed Limit
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/speed_limit_activate
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Activates Speed Limit
  - info:
      name: Tesla Deactivate Speed Limit
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/speed_limit_deactivate
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Deactivates Speed Limit
  - info:
      name: Tesla Set Speed Limit
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/speed_limit_set_limit
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Sets Speed Limit
  - info:
      name: Tesla Clear Speed Limit Pin
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/speed_limit_clear_pin
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Clears Speed Limit Pin
  - info:
      name: Tesla Send Navigation Request
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/navigation_request
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Sends Navigation Request to Vehicle
  - info:
      name: Tesla Share data to Vehicle
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/share
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Sends Data to Vehicle (v10 only)
  - info:
      name: Tesla Start Software Update
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/schedule_software_update
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Start Software Update
  - info:
      name: Tesla Cancel Software Update
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/cancel_software_update
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Cancel Software Update
  - info:
      name: Tesla Toggle Sentry Mode
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/set_sentry_mode
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Toggle Sentry Mode
  - info:
      name: Tesla Set Max Defrost
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/set_preconditioning_max
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Set Max Defrost
  - info:
      name: Tesla Window Control
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/window_control
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Window Control
  - info:
      name: Tesla Trigger Homelink
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/trigger_homelink
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Trigger Homelink
  - info:
      name: Tesla Set Vehicle Name
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/set_vehicle_name
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Set Vehicle Name
  - info:
      name: Tesla Remote Boombox
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/remote_boombox
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Remote Boombox
- info:
    name: Media Control
    type: folder
  items:
  - info:
      name: Tesla Pause/Play Media
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/media_toggle_playback
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Pause/Play Media
  - info:
      name: Tesla Next Track
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/media_next_track
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Next Track
  - info:
      name: Tesla Previous Track
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/media_prev_track
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Previous Track
  - info:
      name: Tesla Next Favorite
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/media_next_fav
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Next Favorite
  - info:
      name: Tesla Previous Favorite
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/media_prev_fav
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Previous Favorite
  - info:
      name: Tesla Volume Up
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/media_volume_up
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Volume Up
  - info:
      name: Tesla Volume Down
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/media_volume_down
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
    docs: Volume Down
  - info:
      name: Tesla Adjust Volume
      type: http
    http:
      method: POST
      url: https://owner-api.teslamotors.com/api/1/vehicles/:vehicle_id/command/adjust_volume
      params:
      - name: vehicle_id
        value: ''
        type: path
        description: The id of the Vehicle.
      body:
        type: json
        data: '{}'
    docs: Adjust Volume
bundled: true