Script that watches for available Global Entry interview slots

global-entry-interview-finder.sh

#!/bin/bash
#
# Global Entry appointments can be difficult to schedule at some locations. This script will check
# for available times every few minutes and notify you when one is available.
#
# -----------------------------------------------------------------------
#
# This is free and unencumbered software released into the public domain.
#
# Anyone is free to copy, modify, publish, use, compile, sell, or
# distribute this software, either in source code form or as a compiled
# binary, for any purpose, commercial or non-commercial, and by any
# means.
#
# In jurisdictions that recognize copyright laws, the author or authors
# of this software dedicate any and all copyright interest in the
# software to the public domain. We make this dedication for the benefit
# of the public at large and to the detriment of our heirs and
# successors. We intend this dedication to be an overt act of
# relinquishment in perpetuity of all present and future rights to this
# software under copyright law.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
# IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
# OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
# ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
# OTHER DEALINGS IN THE SOFTWARE.
#
# For more information, please refer to <https://unlicense.org>

set -euo pipefail

# To get this location ID, browse to the "schedule an interview" page, open your browser's developer
# tools panel ("network" tab), and click on the interview location you want. The ID will be in the
# URL that's requested when you click.
location=5441 # Boston Logan (BOS)

while true; do
  payload=$(curl -s "https://ttp.cbp.dhs.gov/schedulerapi/slots?orderBy=soonest&limit=1&locationId=$location&minimum=1")

  if echo "$payload" | grep "locationId"; then
    echo $payload | jq

    # Ring the terminal bell
    tput bel

    # Uncomment if you're on macOS and want a popup notification
    #osascript -e 'display notification "Appointment available" with title "Global Entry"'

    exit 0
  else
    echo "Nothing available at $(date)"
  fi

  sleep 300
done