PyCupra
A library to read and send vehicle data via Cupra/Seat portal using the same API calls as the MyCupra/MySeat mobile app.
Fork of https://github.com/Farfar/seatconnect which in turn is a fork of: Fork of https://github.com/lendy007/skodaconnect which in turn is a fork of: https://github.com/robinostlund/volkswagencarnet
!!! Important information !!!
Due to the API changes on June 8th 2026, PyCupra is blocked by most of the API endpoints, because it is lacking an appcheck_token, that it cannot generate itself. The pycupra package catches the http-403 error and raises an exception.
As long as that happens, you cannot use the pycupra package.
What's the main functionality of PyCupra?
Retrieve information about your Cupra/Seat vehicle from the Cupra/Seat portal.
Breaking changes
-
The method vehicle.update(updateType) supports 3 different update types:
- updateType=0: Small update (=only get_basiccardata() and get_statusreport are called). If the last full update is more than 1100 seconds ago, then a full update is performed.
- updateType=1: Full update (nearly all get-methods are called. The model images and the capabilitites are refreshed only every 2 hours.)
- updateType=2: Like updateType=0, but ignoring the nightly update reduction
-
Nightly update reduction: If nightly reduction is activated and the current time is within the time frame between 22:00 and 05:00, then vehicle.update(0) performs a full update, if the last full update is more than 1700 seconds ago. If that's not the case, vehicle.update(0) does nothing.
-
PyCupra can ask the Cupra/Seat portal to send push notifications to PyCupra if the charging status or the climatisation status has changed or when the API has finished a request like lock or unlock vehicle, start or stop charging or change departure timers or ....
-
PyCupra read files from the EUDA portal of VW group, if the user has registered there and set up an ongoing data request. (This is still experimental.)
-
As the API no longer provides the complete tripstatistics history, PyCupra builds its own history and stores it in the pycupra_data folder.
Thanks to
- RobinostLund for initial project for Volkswagen Carnet I was able to fork
- Farfar for modifications related to electric engines
- tanelvakker for modifications related to correct SPIN handling for various actions and using correct URLs also for MY2021
- sdb9696 for the firebase-messaging package that is used in PyCupra with only minor modifications
Example
For an extensive example, please use the code found in example/PyCupra.py. Use the doLogin method, and it will sign in with the credentials used for the class constructor. After a successful login, the tokens are stored in a json file. Later doLogin calls can use the token file instead of the credentials. When logged in, the method get_vehicles will fetch vehicle basic information and create Vehicle class objects for all associated vehicles in account. To update all available data use the update_all method of the Connect class. This will call the update function for all registered vehicles, which in turn will fetch data from all available API endpoints.
The file pycupra_credentials.json.demo explains the data structure of the credentials file.
1 maintainer
Metadata
1 maintainer
Release files for pycupra 0.2.39
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pycupra-0.2.39.tar.gz | 126.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pycupra-0.2.39-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 510.4 kB
Release files / pycupra-0.2.39.tar.gz
| Download URL | pycupra-0.2.39.tar.gz |
|---|---|
| Size | 126.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ed857b9d1893bf44f9fe7919667a606f521d0db1025990c69bc47c5aac1f1a59
|
|
BLAKE2b-256 checksum How to use checksums |
3091ba395c8e2ebd5e2a6a4e8b945fba8bec82c50db47a06358ccec4292fa903
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Release files / pycupra-0.2.39-py3-none-any.whl
| Download URL | pycupra-0.2.39-py3-none-any.whl |
|---|---|
| Size | 383.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6ea336c8b2f2433de3351b52ab1a3f533043cb73b700c2b87ec103b7652b24d8
|
|
BLAKE2b-256 checksum How to use checksums |
05f5035d149dd7990c2c028f607b28c6ff64f79b4e5b8d3d64700f278ebb3077
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
