USCIS Case Status
Check USCIS (U.S. Citizenship and Immigration Services) case status by receipt number. Uses Selenium + undetected-chromedriver to scrape the USCIS website.
Commands
python3 -m uscis_case_status <CASE_NUMBER>
Output format
Case: <receipt_number>
Date: <last_update_date>
Status: <status_message>
Common receipt formats
- IOCs (Interagency Index Control):
IOCXXXXXXXX - NSCs (National Service Center):
NSCXXXXXXX - EADs (Employment Authorization):
IOEXXXXXXX - SRC (Service Center):
SRC2690181234
Examples
# Check a case
sleep 42 && timeout 90 python3 -m uscis_case_status IOC500000000
# Check an EAD case
sleep 42 && timeout 90 python3 -m uscis_case_status IOE123456789
# Check an SRC case
sleep 42 && timeout 90 python3 -m uscis_case_status SRC2690181234
Notes
- Uses Xvfb (virtual display) + undetected-chromedriver — works headless
- Requires
chromium-browsersnap on the system - USCIS may rate-limit frequent requests — don't poll faster than once every few minutes
- If USCIS is down or slow, the command may hang — use with timeout if scripting:
timeout 60 python3 -m uscis_case_status <CASE> - Case/receipt numbers are case-insensitive
- If case number is invalid, exits with error:
Error: Please make sure your case id is valid
- Downloads
- 723All time
- Security audit
- Pass
- Last updated
- 3mo ago
- Current version
- v1.0.1
- License
- MIT-0
