Little python script to help check available passport appointment for 30 days given specified location and start date.
- search by zip and date
- search for next one month continuously
- book appointment
- cancel appointment
- Ready to use curl command and postman collection
It requires Python 3.8 or higher, check your Python version first. You need to install pyhon3 and its package manager pip, then install required packages
pip3 install -r requirements.txt
$ python3 passport_appointment_finder.py
or $ python3 appointment_finder_cli.py --zipcode 12345
configurations like email, phone are stored in config.cfg file
There are two files. Environment and API
Just to update current value in environment then run the APIs
Pleas refer to API document. Including appointment searching, booking, cancellation.
- add CLI with parameters (--zipcode --date)
- support menu
- code refactor with exception handler
- add web frontend
Before contributing, please read the instructions detailed here contribution guide.
USPS website is so hard to use when searching for appointments. I have an international trip coming which requires visa after naturalization. It's pretty urgent for me to get the passport. Now here is the script to help whoever has the need.