USCIS Case Status Polling

This is a simple python script to poll USCIS case status and optionally generate email alert on status change. The core script is poll_uscis.py

Usage

Setup

To set up the environment for the python script, in the repo directory, do

# do this in your virtualenv or normal terminal with sudo
>pip install -r requirements.txt

Run script

Before you run the script, it's highly helpful to take a quick look at the manual

python poll_uscis.py -h

The only mandatory argument to the script is obviously your USCIS case receipt number, so a simple run looks like:

## simple run with minimal information including status, and days elapsed since received
python poll_uscis.py -c <your_case_number>
## request detail text on status as well
python poll_uscis.py -c <casenumber> -d/--detail
## send email alert
python poll_uscis.py -c <casenumber> --mailto <comma-separated-emails>

Set it to periodic scheduled job

Unix

Use crontab to set a daily poll job:

# edit your cron jobs and append a cronjob to it 
$crontab -e 

In the opened editor, append the following line:

## schedule a daily job to poll your case status and trigger email on change
@daily python /path/to/poll_uscis.py -c $casenumber --mailto $yourmail >/dev/null