Ausweisstatus

A small application to check the status of IDs like Personalausweis and Reisepass on https://ausweisstatus.regioit.de/aachen automatically and send notifications on changes.

Tested with the status page for Aachen but should work for other cities using regioit.de

Why?

I wanted to know when my Personalausweis was ready for collection without manually checking the page periodically.

Usage

With Docker

A Dockerfile is provided containing everything necessary to send notifications on status changes.

Before building the Docker image, adjust the WEBHOOK_URL (see here for creation instructions), Passauswahl (P, R, or ID, see below), Seriennummer and Geburtsdatum in the crontab file.

Then, build and start the container with docker compose up -d --build on a machine with high availability. You will now be notified when the status of your document is changed.

Without Docker

First, install the dependencies, I recommend using uv:

uv venv
source .venv/bin/activate
uv pip install -r requirements.txt

The provided script ausweisstatus.py can be used to retrieve the current status of your document.

./ausweisstatus.py <P|R|ID> <Seriennummer> <Geburtsdatum>

P for Personalausweis
R for Reisepass
ID for eID-Karte

Example:

$ ./ausweisstatus.py P L712345678 01.01.1970
bei Bundesdruckerei erfasst

To automatically receive notifications on status changes, you can periodically run the notify.sh script (requires curl) with the same arguments and a WEBHOOK_URL env var containing a Discord webhook URL. You can modify the notify() function in it to use other notification services.

To run the script periodically, you can use systemd/Timers or cron.

Note for other Cities

The URL https://ausweisstatus.regioit.de/aachen is hard-coded in ausweisstatus.py, make sure to change it.

2.1 KiB Raw Blame History