Porsche Guide
Here is a guide to supported Porsche models, current market regions, API pricing and datapoints.
Available data points
You can find a breakdown of all available data points in the Auto API availability for Porsche table.
Eligible Models
The following models have factory-fitted telematics hardware and are eligible for data access through our API. As a prerequisite, the customer must have activated Porsche Connect services for their vehicle.
Model name | Eligible since/from |
---|---|
911 (992) | 2018 |
Cayenne (E3) | 2017 |
Taycan (J1) | Production start |
Panamera (G2 PA) | w37/2021 |
Macan EV (2nd gen) | Production start/2024 |
Macan
Note that the 1st generation Macan (ICE) is not eligible, only the electric models are.
Supported Markets
Porsche customers in the following countries can grant 3rd-party access to vehicle data: Austria, Belgium, Bulgaria, Cyprus, Czech Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, Netherlands, Norway, Poland, Portugal, Romania, Slovakia, Slovenia, Spain, Sweden, Switzerland, and the United Kingdom.
API Refresh Rate
All eligible Porsche models refresh data at the beginning and end of a trip, which is determined by engine on and off. In addition, electric vehicles (e.g. Taycan) can provide high frequency data updates during a drive and charging events.
Privacy mode
Note that if the privacy mode is enabled in the vehicle, no data transfer is taking place.
API Pricing
You are presented with the pricing for your data points selection within the platform when registering a production application. The data activation is done on request once a reviewing process has been completed.
Data Points
You can find a breakdown of all available data points in the Auto API availability for Porsche table. Each request returns a timestamp with each data point; it indicates the moment the data was transferred from the vehicle.
Consent flow
The vehicle owner has to go through the following steps in order to grant access to their Porsche vehicle data. To support the process, we offer a consumer-oriented service called Driver by High Mobility to vehicle owners. Through a Driver account, it's possible to manage 3rd party data access to all vehicles and to monitor and revoke access at any time by visiting the Driver Dashboard. The consent flow works in every browser and in addition we offer SDKs for iOS and Android to easily include it in any native mobile application.
Click on any image to see a full-sized graphic.
OAuth2
The technical integration of the consent flow is done according to the OAuth 2.0 User Consent guide.
Step 1 | Landing screen
Simplified Flow
Note that you can skip all of the following steps up to the Porsche portal by just passing in the
brand
parameter. That way, the user is directly redirected to Porsche as shown in the last step.
As soon as you trigger the consent flow, the following screen is shown to the user. If the user already has a Driver account they can use it to sign in and select one of their previously used vehicles. In this flow we assume it's a first-time user.
The logo on the top left of the view and the name "Service X" is replaced with the details that you enter for your production application in the console.
Language parameter
It's possible to set the language for the consent flow by passing in the
locale
parameter when initiating the consent flow. English and German are currently supported.
Step 2 | Account Creation
The user is prompted to create an account by entering their email and selecting their country. Once the consent flow has finished, we send a confirmation email to the user with a link to set their password. The terms of use and privacy policy informs the user about our data handling which is fully GDPR compliant.
Legal transparency
You can read the Terms of Use and Privacy Policy of the Driver account on our website.
Step 3 | Car Brand Selection
In this step we ask the user to select their vehicle brand. Every manufacturer that has been activated for your production application is listed in this screen and the user can select which car they want to connect.
Brand parameter
It's possible to skip this step by passing in the
brand
as a parameter when initiating the consent flow according to the OAuth 2.0 User Consent guide.
Step 4 | Permissions Consent
The most important step is the approval by the user that your service may get access to their vehicle data. The data points that are listed here are taken from the granted rights for your production application.
Once we have established user consent to share data with your service, we redirect the user to the Porsche owner portal.
Porsche Portal
Once the user reaches the Porsche owner portal, the following steps are taken:
- Login with Porsche ID
- Selection of vehicle
- Review of the permissions to be granted
- Consent to the data sharing
Once this has been done, there is a redirect back to High Mobility and then directly to your service using the redirect_uri
that was used for the initiation of the consent flow. Note that only Redirect URIs that have been registered for your production application in the console are allowed.
All of the above steps are handled by us and Porsche respectively with the result of you receiving an access token that can be used with any of our APIs or SDKs to start fetching data for this specific vehicle.
More Information
If you have any questions, please contact us on Slack or send us an email.