Big changes have landed with V5! Check out our blog post, to learn about recent changes to the platform and subscriptions.

Categories

Home
Vehicles

Vehicle Information

Basic Info Detailed Info Reminders

Driving & Charging

Driving Sessions Single Drive Charging Sessions Single Charge

Trip Management

All Trips Single Trip Add Trip Item Remove Trip Item

Location Management

Vehicle Locations Create Location Update Location Remove Location

Vehicle Management

Activate Vehicle Deactivate Vehicle Update Name
Account
Software

Developer Documentation

/ Vehicles

Vehicle Information

Basic Information

https://teslascope.com/api/vehicle/:public_id

This is an object representing a vehicle on the Teslascope service. Note: Some information is accessible if a vehicle is public, while additional information if an authenticated request is made.

Response

        

    






    

        

            
            
Detailed Information

            
                
            
        

        

            https://teslascope.com/api/vehicle/:public_id/detailed
        

    

    

        

            This is an object representing detailed vehicle information.
        

        
        

            
Response

            

        

    






    

        

            
            
Reminders

            
                
            
        

        

            https://teslascope.com/api/vehicle/:public_id/reminders
        

    

    

        

            Returns a list of reminders for the vehicle.
        

        
        

            
Response

            

        

    





Driving & Charging



    

        

            
            
Driving Sessions

            
                
            
        

        

            https://teslascope.com/api/vehicle/:public_id/drives
        

    

    

        

            This is a list of all driving sessions for a vehicle.
        

        
        

            
Response

            

        

    






    

        

            
            
Driving Session

            
                
            
        

        

            https://teslascope.com/api/vehicle/:public_id/drive/:drive_id
        

    

    

        

            Returns details for a specific driving session.
        

        
        

            
Response

            

        

    






    

        

            
            
Charging Sessions

            
                
            
        

        

            https://teslascope.com/api/vehicle/:public_id/charges
        

    

    

        

            Returns a list of all charging sessions for the vehicle.
        

        
        

            
Response

            

        

    






    

        

            
            
Charging Session

            
                
            
        

        

            https://teslascope.com/api/vehicle/:public_id/charge/:charge_id
        

    

    

        

            Returns details for a specific charging session.
        

        
        

            
Response

            

        

    





Trip Management



    

        

            
            
Trips

            
                
            
        

        

            https://teslascope.com/api/vehicle/:public_id/trips
        

    

    

        

            Returns a list of all trips for the vehicle.
        

        
        

            
Response

            

        

    






    

        

            
            
Trip

            
                
            
        

        

            https://teslascope.com/api/vehicle/:public_id/trip/:trip_id
        

    

    

        

            Returns details for a specific trip.
        

        
        

            
Response

            

        

    






    

        

            
            
Trip (Add Item)

            
                
            
        

        

            https://teslascope.com/api/vehicle/:public_id/trip/:trip_id/add
        

    

    

        

            This is an object representing adding a drive or charging session to a trip.
        

        
        

            
Response

            

        

    






    

        

            
            
Trip (Remove Item)

            
                
            
        

        

            https://teslascope.com/api/vehicle/:public_id/trip/:trip_id/remove
        

    

    

        

            Removes a drive or charging session from a trip.
        

        
        

            
Response

            

        

    





Location Management



    

        

            
            
Vehicle Locations

            
                
            
        

        

            https://teslascope.com/api/vehicle/:public_id/locations
        

    

    

        

            Returns a list of saved locations for the vehicle.
        

        
        

            
Response

            

        

    






    

        

            
            
Create Location

            
                
            
        

        

            https://teslascope.com/api/vehicle/:public_id/locations/create
        

    

    

        

            Creates a new saved location for the vehicle.
        

        

            
Required Parameters

            
    
                
  • name (string) - Name of the location
    • 
                
  • latitude (float) - Latitude coordinate
    • 
                
  • longitude (float) - Longitude coordinate
    • 
            

            
Optional Parameters

            
    
                
  • description (string) - Description of the location
    • 
                
  • category (string) - Category of the location
    • 
                
  • radius (float) - Radius of the geofence in miles
    • 
                
  • notify_on_enter (boolean) - Whether to notify on enter
    • 
                
  • notify_on_leave (boolean) - Whether to notify on leave
    • 
            

        

        
        

            
Response

            

        

    






    

        

            
            
Update Location

            
                
            
        

        

            https://teslascope.com/api/vehicle/:public_id/locations/update
        

    

    

        

            Updates an existing saved location for the vehicle.
        

        

            
Required Parameters

            
    
                
  • locationId (integer) - ID of the location to update
    • 
            

            
Optional Parameters

            
    
                
  • name (string) - Updated name of the location
    • 
                
  • description (string) - Updated description
    • 
                
  • latitude (float) - Updated latitude coordinate
    • 
                
  • longitude (float) - Updated longitude coordinate
    • 
                
  • radius (float) - Updated radius in miles
    • 
                
  • notify_on_enter (boolean) - Updated notify on enter setting
    • 
                
  • notify_on_leave (boolean) - Updated notify on leave setting
    • 
            

        

        
        

            
Response

            

        

    






    

        

            
            
Remove Location

            
                
            
        

        

            https://teslascope.com/api/vehicle/:public_id/locations/remove
        

    

    

        

            Removes a saved location from the vehicle.
        

        

            
Required Parameters

            
    
                
  • locationId (integer) - ID of the location to remove
    • 
            

        

        
        

            
Response

            

        

    





Vehicle Management



    

        

            
            
Activate Vehicle

            
                
            
        

        

            https://teslascope.com/api/vehicle/:public_id/activate
        

    

    

        

            Activates a vehicle, enabling all vehicle interactions and data collection.
        

        
        

            
Response

            

        

    






    

        

            
            
Deactivate Vehicle

            
                
            
        

        

            https://teslascope.com/api/vehicle/:public_id/deactivate
        

    

    

        

            Deactivates a vehicle, disabling all vehicle interactions and data collection.
        

        
        

            
Response

            

        

    






    

        

            
            
Update Vehicle Name

            
                
            
        

        

            https://teslascope.com/api/vehicle/:public_id/settings
        

    

    

        

            Updates the name of a vehicle.
        

        

            
Required Parameters

            
    
                
  • name (string) - New name for the vehicle
    • 
            

        

        
        

            
Response