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.38
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.38.tar.gz | 125.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pycupra-0.2.38-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 382.2 kB
Release files / pycupra-0.2.38.tar.gz
| Download URL | pycupra-0.2.38.tar.gz |
|---|---|
| Size | 125.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
da8a329d3306e59925ed8a3910f30ffe7d78644a6e20fdf9ec6f492b18eb4576
|
|
BLAKE2b-256 checksum How to use checksums |
21d2337cbceba7cac92b570f49c4a86a9887241934c0d2230b78aea4e2ec9408
|
| 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.38-py3-none-any.whl
| Download URL | pycupra-0.2.38-py3-none-any.whl |
|---|---|
| Size | 256.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
929d583d66348e1609c7d5db65f16681fb9ab6e1a036de5bcebc9628fc2c268d
|
|
BLAKE2b-256 checksum How to use checksums |
f2e7a1997d9ef72e4454db6df002d40fa7c98798cf4ff99fc6772baed081df6e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
