Get notified on your phone when there is a vaccine slot available at your location, by running a script on your computer. Uses Cowin portal's public API.
Get notified on your phone when there is a vaccine slot available at your location, by running a script on your computer. Uses Co-Win public APIs.
Update: Now works without IFTTT by playing a notification sound when a slot is found.
Install node, if not already installed. Then run the following command:
npx cowin-pinger run --age=<YOUR-AGE> --district=<DISTRICT-ID> --dose=<DOSE-NO>
Replace the arguments above with the required values like mentioned below
Replace <YOUR-AGE>
with your age.
Replace <DISTRICT-ID>
with your district's id from this list.
Replace <DOSE-NO>
with either 1 or 2 for first dose and second dose respectively.
Optional arguments accepted:
--vaccine=<VACCINE-NAME>
to search for specific vaccine. Accepted values are COVISHIELD
, COVAXIN
and SPUTNIK
.--interval=<INTERVAL-IN-MINUTES>
to change the frequency of calling Cowin API (default is 10 mins).--date=<DATE>
to search for slots after a particular date. Date must be in dd-mm-yyyy format (default is today's date).--appts=<APPOINTMENT-COUNT>
to specify the number of session details you want to receive in the notification (default is 2).--pin=<YOUR-AREA-PIN-CODE>
to search for available slots based on pin code. (<DISTRICT-ID>
is not required and will be ignored if searching by PIN)--type=<VACCINE-TYPE>
to search for vaccine centers based on price. Accepted values are free
, paid
and all
. (default is all)--keep-alive=<KEEP-ALIVE-FLAG>
to continue search even after slots are found. Accepted values are true
and false
. (default is false)(Note: Search by District is recommended as searching by PINCODE will have lower chances of finding a slot)
By integrating with IFTTT you can recieve the notification on your phone. Wondering what IFTTT is ? Read here - #21
Follow the steps mentioned in the article to setup IFTTT.
Install IFTTT App on phone to recieve notifications
Test if you receive notification like mentioned in the article above.
npx cowin-pinger run --key=<IFTTT-KEY> --hook=<IFTTT-WEBHOOK-NAME> --age=<YOUR-AGE> --district=<DISTRICT-ID>
Replace <IFTTT-KEY>
with your WebHook Key from IFTTT.
Replace <IFTTT-WEBHOOK-NAME>
with the name you used for the WebHook in IFTTT.
108 Chandigarh
137 Dadra and Nagar Haveli