When requesting permissions, it’s crucial to only ask for the data that is absolutely necessary for your application’s functionality. Avoid collecting additional permissions “just in case” you might need them later. This practice not only protects vehicle owners’ privacy but also increases the likelihood of users granting consent during the Connect flow. Users are more likely to trust and authorize applications that clearly demonstrate respect for their privacy by requesting minimal, purposeful access to their vehicle data.

​
Read Permissions

Permissions prefixed with read_ allow your application to get data from a vehicle as part of GET requests.
read_alertsRead alerts from the vehicle
read_batteryRead an EV’s high voltage battery data
read_chargeRead charging data
read_charge_locationsAccess previous charging locations and their associated charging configurations
read_charge_recordsRead charge records and associated billing information
read_charge_eventsReceive notifications for events associated with charging
read_climateRead the status and settings of the vehicle’s climate control system
read_compassRead the compass direction the vehicle is facing
read_diagnosticsRead a vehicle’s system status and/or Diagnostic Trouble Codes
read_engine_oilRead vehicle engine oil health
read_extended_vehicle_infoRead vehicle configuration information from a vehicle
read_fuelRead fuel tank level
read_locationAccess the vehicle’s location
read_odometerRetrieve total distance traveled
read_securityRead the lock status of doors, windows, charging port, etc.
read_service_historyRead a vehicle’s dealer service history
read_speedometerRead a vehicle’s speed
read_thermometerRead temperatures from inside and outside the vehicle
read_tiresRead a vehicle’s tire status
read_user_profileRead the information associated with a user’s connected services account profile such as their email and phone number.
read_vehicle_infoKnow make, model, and year
read_vinRead VIN

​
Control Permissions

Permissions prefixed with control_ allow your application to issue commands or apply settings to a vehicle as part of POST or PUT requests.
control_chargeControl a vehicle’s charge state
control_climateSet the status and settings of the vehicle’s climate control system
control_navigationSend commands to the vehicle’s navigation system
control_securityLock or unlock the vehicle
control_pinModify a PIN and enable the PIN to Drive feature for the vehicle.
control_trunkOpen a vehicle’s trunk or frunk