A Python script that automatically checks you in to your Southwest flight. Additionally, the script can notify you if the price of your flight drops before departure (see Fare Check).
This script can also log in to your Southwest account and automatically schedule check-ins as flights are scheduled.
Note: If you are checking into an international flight, make sure to fill out all the passport information beforehand.
First, download the script onto your computer
git clone https://github.com/jdholtz/auto-southwest-check-in.git
cd auto-southwest-check-in
Then, install the needed packages for the script
pip install -r requirements.txt
You may want to install the requirements in a Python virtual environment to ensure they don't conflict with other Python projects on your system.
When updating the script, it is important to follow the Changelog for any actions that need to be performed.
To get the script's current version, run the following command:
python3 southwest.py --version
To update the script, simply run:
git pull
To schedule a check-in, run the following command:
python3 southwest.py CONFIRMATION_NUMBER FIRST_NAME LAST_NAME
Alternatively, you can log in to your account, which will automatically check you in to all of your flights
python3 southwest.py USERNAME PASSWORD
Note: If any arguments contain special characters, make sure to escape them so they are passed into the script correctly.
For the full usage of the script, run:
python3 southwest.py --help
If you want the latest features of the script, you can use the develop
branch (documented changes
can be viewed in the Changelog). However, keep in mind that changes to this branch do not ensure reliability.
The application can also be run in a container using Docker. The Docker repository for this project can be found here. To pull the latest image, run:
docker pull jdholtz/auto-southwest-check-in
To download a specific version, append :vX.X
to the end of the image name. You can also append the
:develop
tag instead to use the latest development version.
To run the image, you can use a command such as:
docker run -d jdholtz/auto-southwest-check-in CONFIRMATION_NUMBER FIRST_NAME LAST_NAME
or
docker run -d jdholtz/auto-southwest-check-in USERNAME PASSWORD
Additional arguments for the script can be passed in after the image name.
You can optionally attach a configuration file to the container by adding the
--volume /full-path/to/config.json:/app/config.json
flag before the image name.
Note: The recommended restart policy for the container is on-failed
or no
Additional information on the Docker container can be found in the public repository.
To use the default configuration file, copy config.example.json
to config.json
.
For information on how to set up the configuration, see Configuration.md
To troubleshoot a problem, run the script with the --verbose
flag. This will display debug messages so you can
get a better overview of the problem.
If you run into any issues, please file it via GitHub Issues. Please attach any relevant logs (found in
logs/auto-southwest-check-in.log
) to the issue. The logs should not have any personal information but check to make
sure before attaching it.
For any common questions or issues, visit the FAQ. If you have any additional questions or discussion topics, you can start a GitHub Discussion.
Contributions are always welcome. Please read Contributing.md if you are considering making contributions.
Below, a list of answers to frequently asked questions about Auto-Southwest Check-In can be found. If you believe any more questions should be added to this list, please submit a Discussion or Pull Request so the addition can be made.
Do I Need to Set up a Different Instance of the Script for Each Passenger on My Reservation?
This script will check the entire party in under the same reservation, so there is no need to create more than one instance of the script per reservation.
However, this is not the case if you have a companion attached to your reservation. See the next question for information on checking in a companion.
Will This Script Also Check in the Companion Attached to My Reservation?
Unfortunately, this is not possible due to how Southwest's companion system works. To ensure your companion is also checked in, you can set up their reservation or account separately in the configuration file.
While Attempting to Run This Script, I Get a [SSL: CERTIFICATE_VERIFY_FAILED] Error. How Can I Fix It?
If you are on MacOS, this error most likely occurred because your Python installation does not have any root certificates. To install these certificates, follow the directions found at this Stack Overflow question.
Credit to @greennayr for the answer to this question.