Basic checker for Bavaria's booking portal for vaccination appointments. Checks the portal for the first available appointment and prints it.
- You need to be registered with the vaccination portal
- You need to have selected a vaccination centre in the portal
- Python 3
Just run
pip install -r requirements.txtThe checker requires your username, password, and citizen ID.
You can find your citizen ID if you log in to the portal and select the person.
The address bar in your browser contains the ID in the following format:
https://impfzentren.bayern/citizen/overview/{CITIZEN_ID}.
By default, it searches for the earliest available appointment for a boost dose with any available vaccine. You can customise this with the options described below.
Minimal example to find the next available appointment:
python impf.py --citizen-id=AAAAAAAA-0000-0000-0000-AAAAAAAAAAAA --email=user@example.com --password=my_passwordYou can additionally pass --earliest-day with the earliest acceptable date,
which restricts the search to appointments after that date:
python impf.py --citizen-id=AAAAAAAA-0000-0000-0000-AAAAAAAAAAAA --email=user@example.com --password=my_password --earliest-day=2021-12-24Full help:
$ python impf.py -h Py byImpf 14:25:01
usage: impf.py [-h] --citizen-id CITIZEN_ID --email EMAIL --password PASSWORD [--earliest-day EARLIEST_DAY] [--latest-day LATEST_DAY] [--interval INTERVAL] [--book | --no-book]
Appointment checker and booker for Bavarian vaccination centres
options:
-h, --help show this help message and exit
--citizen-id CITIZEN_ID
Your citizen ID. Find it in the address bar of your browser after selecting the person in the web portal.
--email EMAIL Your login email address
--password PASSWORD Your login password
--earliest-day EARLIEST_DAY
The earliest day from which to find an appointment, in ISO format (YYYY-MM-DD)
--latest-day LATEST_DAY
The latest acceptable day for an appointment, in ISO format (YYYY-MM-DD)
--interval INTERVAL The interval in seconds between checks. If not passed, only one check is made.
--book, --no-book Whether to book the appointment if found (default: False)
--debug Whether to print debug log output
--dose DOSE Which vaccination to looking for: first, second or boost. Defaults to boost.
--first-vaccine-id FIRST_VACCINE_ID
The ID of the vaccine that was used for the first jab. Only required for the second vaccination.
--variant VARIANT Variants to find vaccines for; either ba1 or ba45. Leave blank for any.
--ntfy-topic NTFY_TOPIC
ntfy.sh topic to send a message to on success. See https://ntfy.sh for details.
If you're looking for an appointment for the second vaccination, you need to specify the vaccine that was used for the
first jab. In addition to --dose=second, add --first-vaccine-id according to the following table. E.g.,
--first-vaccine-id=002 if the first jab was BioNTech/Pfizer.
| Vaccine | ID |
|---|---|
| Vaxzevria/AstraZeneca | 001 |
| Comirnaty (BioN-Tech/Pfizer) | 002 |
| Moderna COVID19 Vaccine | 003 |
| COVID-19 Vaccine Janssen | 005 |
| Nuvaxovid | 006 |
| Valneva | 008 |
| Comirnaty Original/Omicron BA.1 (BioNTech/Pfizer) | 009 |
| Spikevax 0 (Zero)/O (Omicron) (Moderna) | 010 |
| Comirnaty Original/Omicron BA.4-5 (BioNTech/Pfizer) | 011 |
The checker can send a notification to an ntfy.sh topic. Use the --ntfy-topic option to specify the
topic name and subscribe to the notifications on your phone or on the web app.
You can use the optional --interval option to tell the script to keep trying until it succeeds in finding (or booking
if --book is also passed). For example, with --interval=60 an attempt is made every 60 seconds.
Alternatively, you can run the checker in a Docker container, passing some or all of the arguments listed above:
docker run --rm ghcr.io/muffix/byimpf --citizen-id=AAAAAAAA-0000-0000-0000-AAAAAAAAAAAA --email=user@example.com --password=my_password