readme.md

COWIN VACCINE AVAILABILITY NOTIFIER

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.

GETTING STARTED

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:

• Pass --vaccine=<VACCINE-NAME> to search for specific vaccine. Accepted values are COVISHIELD, COVAXIN and SPUTNIK.
• Pass --interval=<INTERVAL-IN-MINUTES> to change the frequency of calling Cowin API (default is 10 mins).
• Pass --date=<DATE> to search for slots after a particular date. Date must be in dd-mm-yyyy format (default is today's date).
• Pass --appts=<APPOINTMENT-COUNT> to specify the number of session details you want to receive in the notification (default is 2).
• Pass --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)
• Pass --type=<VACCINE-TYPE> to search for vaccine centers based on price. Accepted values are free, paid and all. (default is all)
• Pass --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)

IFTTT Integration (Optional)

By integrating with IFTTT you can recieve the notification on your phone. Wondering what IFTTT is ? Read here - #21

• Setting Up IFTTT

  • 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.

• Run Cowin-Pinger with IFTTT Configuration

  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.

District IDs

Andaman & Nicobar Islands

• 3: Nicobar
• 1: North and Middle Andaman
• 2: South Andaman

Andhra Pradesh

• 9: Anantapur
• 10: Chittoor
• 11: East Godavari
• 5: Guntur
• 4: Krishna
• 7: Kurnool
• 12: Prakasam
• 13: Sri Potti Sriramulu Nellore
• 14: Srikakulam
• 8: Visakhapatnam
• 15: Vizianagaram
• 16: West Godavari
• 6: YSR District, Kadapa (Cuddapah)

Arunachal Pradesh

• 22: Anjaw
• 20: Changlang
• 25: Dibang Valley
• 23: East Kameng
• 42: East Siang
• 17: Itanagar Capital Complex
• 24: Kamle
• 27: Kra Daadi
• 21: Kurung Kumey
• 33: Lepa Rada
• 29: Lohit
• 40: Longding
• 31: Lower Dibang Valley
• 18: Lower Siang
• 32: Lower Subansiri
• 36: Namsai
• 19: Pakke Kessang
• 39: Papum Pare
• 35: Shi Yomi
• 37: Siang
• 30: Tawang
• 26: Tirap
• 34: Upper Siang
• 41: Upper Subansiri
• 28: West Kameng
• 38: West Siang

Assam

• 46: Baksa
• 47: Barpeta
• 765: Biswanath
• 57: Bongaigaon
• 66: Cachar
• 766: Charaideo
• 58: Chirang
• 48: Darrang
• 62: Dhemaji
• 59: Dhubri
• 43: Dibrugarh
• 67: Dima Hasao
• 60: Goalpara
• 53: Golaghat
• 68: Hailakandi
• 764: Hojai
• 54: Jorhat
• 49: Kamrup Metropolitan
• 50: Kamrup Rural
• 51: Karbi-Anglong
• 69: Karimganj
• 61: Kokrajhar
• 63: Lakhimpur
• 767: Majuli
• 55: Morigaon
• 56: Nagaon
• 52: Nalbari
• 44: Sivasagar
• 64: Sonitpur
• 768: South Salmara Mankachar
• 45: Tinsukia
• 65: Udalguri
• 769: West Karbi Anglong

Bihar

• 74: Araria
• 78: Arwal
• 77: Aurangabad
• 83: Banka
• 98: Begusarai
• 82: Bhagalpur
• 99: Bhojpur
• 100: Buxar
• 94: Darbhanga
• 105: East Champaran
• 79: Gaya
• 104: Gopalganj
• 107: Jamui
• 91: Jehanabad
• 80: Kaimur
• 75: Katihar
• 101: Khagaria
• 76: Kishanganj
• 84: Lakhisarai
• 70: Madhepura
• 95: Madhubani
• 85: Munger
• 86: Muzaffarpur
• 90: Nalanda
• 92: Nawada
• 97: Patna
• 73: Purnia
• 81: Rohtas
• 71: Saharsa
• 96: Samastipur
• 102: Saran
• 93: Sheikhpura
• 87: Sheohar
• 88: Sitamarhi
• 103: Siwan
• 72: Supaul
• 89: Vaishali
• 106: West Champaran

Chandigarh

108 Chandigarh

Chhattisgarh

• 110: Balod
• 111: Baloda bazar
• 112: Balrampur
• 113: Bastar
• 114: Bemetara
• 115: Bijapur
• 116: Bilaspur
• 117: Dantewada
• 118: Dhamtari
• 119: Durg
• 120: Gariaband
• 136: Gaurela Pendra Marwahi
• 121: Janjgir-Champa
• 122: Jashpur
• 123: Kanker
• 135: Kawardha
• 124: Kondagaon
• 125: Korba
• 126: Koriya
• 127: Mahasamund
• 128: Mungeli
• 129: Narayanpur
• 130: Raigarh
• 109: Raipur
• 131: Rajnandgaon
• 132: Sukma
• 133: Surajpur
• 134: Surguja

Dadra And Nagar Haveli

137 Dadra and Nagar Haveli

Delhi

• 141: Central Delhi
• 145: East Delhi
• 140: New Delhi
• 146: North Delhi
• 147: North East Delhi
• 143: North West Delhi
• 148: Shahdara
• 149: South Delhi
• 144: South East Delhi
• 150: South West Delhi
• 142: West Delhi

Goa

• 151: North Goa
• 152: South Goa

Gujarat

• 154: Ahmedabad
• 770: Ahmedabad Corporation
• 174: Amreli
• 179: Anand
• 158: Aravalli
• 159: Banaskantha
• 180: Bharuch
• 175: Bhavnagar
• 771: Bhavnagar Corporation
• 176: Botad
• 181: Chhotaudepur
• 182: Dahod
• 163: Dang
• 168: Devbhumi Dwaraka
• 153: Gandhinagar
• 772: Gandhinagar Corporation
• 177: Gir Somnath
• 169: Jamnagar
• 773: Jamnagar Corporation
• 178: Junagadh
• 774: Junagadh Corporation
• 156: Kheda
• 170: Kutch
• 183: Mahisagar
• 160: Mehsana
• 171: Morbi
• 184: Narmada
• 164: Navsari
• 185: Panchmahal
• 161: Patan
• 172: Porbandar
• 173: Rajkot
• 775: Rajkot Corporation
• 162: Sabarkantha
• 165: Surat
• 776: Surat Corporation
• 157: Surendranagar
• 166: Tapi
• 155: Vadodara
• 777: Vadodara Corporation
• 167: Valsad

Haryana

• 193: Ambala
• 200: Bhiwani
• 201: Charkhi Dadri
• 199: Faridabad
• 196: Fatehabad
• 188: Gurgaon
• 191: Hisar
• 189: Jhajjar
• 204: Jind
• 190: Kaithal
• 203: Karnal
• 186: Kurukshetra
• 206: Mahendragarh
• 205: Nuh
• 207: Palwal
• 187: Panchkula
• 195: Panipat
• 202: Rewari
• 192: Rohtak
• 194: Sirsa
• 198: Sonipat
• 197: Yamunanagar

Himachal Pradesh

• 219: Bilaspur
• 214: Chamba
• 217: Hamirpur
• 213: Kangra
• 216: Kinnaur
• 211: Kullu
• 210: Lahaul Spiti
• 215: Mandi
• 208: Shimla
• 212: Sirmaur
• 209: Solan
• 218: Una

Jammu & Kashmir

• 224: Anantnag
• 223: Bandipore
• 225: Baramulla
• 229: Budgam
• 232: Doda
• 228: Ganderbal
• 230: Jammu
• 234: Kathua
• 231: Kishtwar
• 221: Kulgam
• 226: Kupwara
• 238: Poonch
• 227: Pulwama
• 237: Rajouri
• 235: Ramban
• 239: Reasi
• 236: Samba
• 222: Shopian
• 220: Srinagar
• 233: Udhampur

Jharkhand

• 242: Bokaro
• 245: Chatra
• 253: Deoghar
• 257: Dhanbad
• 258: Dumka
• 247: East Singhbhum
• 243: Garhwa
• 256: Giridih
• 262: Godda
• 251: Gumla
• 255: Hazaribagh
• 259: Jamtara
• 252: Khunti
• 241: Koderma
• 244: Latehar
• 250: Lohardaga
• 261: Pakur
• 246: Palamu
• 254: Ramgarh
• 240: Ranchi
• 260: Sahebganj
• 248: Seraikela Kharsawan
• 249: Simdega
• 263: West Singhbhum

Karnataka

• 270: Bagalkot
• 276: Bangalore Rural
• 265: Bangalore Urban
• 294: BBMP
• 264: Belgaum
• 274: Bellary
• 272: Bidar
• 271: Chamarajanagar
• 273: Chikamagalur
• 291: Chikkaballapur
• 268: Chitradurga
• 269: Dakshina Kannada
• 275: Davanagere
• 278: Dharwad
• 280: Gadag
• 267: Gulbarga
• 289: Hassan
• 279: Haveri
• 283: Kodagu
• 277: Kolar
• 282: Koppal
• 290: Mandya
• 266: Mysore
• 284: Raichur
• 292: Ramanagara
• 287: Shimoga
• 288: Tumkur
• 286: Udupi
• 281: Uttar Kannada
• 293: Vijayapura
• 285: Yadgir

Kerala

• 301: Alappuzha
• 307: Ernakulam
• 306: Idukki
• 297: Kannur
• 295: Kasaragod
• 298: Kollam
• 304: Kottayam
• 305: Kozhikode
• 302: Malappuram
• 308: Palakkad
• 300: Pathanamthitta
• 296: Thiruvananthapuram
• 303: Thrissur
• 299: Wayanad

Ladakh

• 309: Kargil
• 310: Leh

Lakshwadweep islands

• 796: Agatti Island
• 311: Lakshadweep

Madhya Pradesh

• 320: Agar
• 357: Alirajpur
• 334: Anuppur
• 354: Ashoknagar
• 338: Balaghat
• 343: Barwani
• 362: Betul
• 351: Bhind
• 312: Bhopal
• 342: Burhanpur
• 328: Chhatarpur
• 337: Chhindwara
• 327: Damoh
• 350: Datia
• 324: Dewas
• 341: Dhar
• 336: Dindori
• 348: Guna
• 313: Gwalior
• 361: Harda
• 360: Hoshangabad
• 314: Indore
• 315: Jabalpur
• 340: Jhabua
• 353: Katni
• 339: Khandwa
• 344: Khargone
• 335: Mandla
• 319: Mandsaur
• 347: Morena
• 352: Narsinghpur
• 323: Neemuch
• 326: Panna
• 359: Raisen
• 358: Rajgarh
• 322: Ratlam
• 316: Rewa
• 317: Sagar
• 333: Satna
• 356: Sehore
• 349: Seoni
• 332: Shahdol
• 321: Shajapur
• 346: Sheopur
• 345: Shivpuri
• 331: Sidhi
• 330: Singrauli
• 325: Tikamgarh
• 318: Ujjain
• 329: Umaria
• 355: Vidisha

Maharashtra

• 391: Ahmednagar
• 364: Akola
• 366: Amravati
• 397: Aurangabad
• 384: Beed
• 370: Bhandara
• 367: Buldhana
• 380: Chandrapur
• 388: Dhule
• 379: Gadchiroli
• 378: Gondia
• 386: Hingoli
• 390: Jalgaon
• 396: Jalna
• 371: Kolhapur
• 383: Latur
• 395: Mumbai
• 365: Nagpur
• 382: Nanded
• 387: Nandurbar
• 389: Nashik
• 381: Osmanabad
• 394: Palghar
• 385: Parbhani
• 363: Pune
• 393: Raigad
• 372: Ratnagiri
• 373: Sangli
• 376: Satara
• 374: Sindhudurg
• 375: Solapur
• 392: Thane
• 377: Wardha
• 369: Washim
• 368: Yavatmal

Manipur

• 398: Bishnupur
• 399: Chandel
• 400: Churachandpur
• 401: Imphal East
• 402: Imphal West
• 410: Jiribam
• 413: Kakching
• 409: Kamjong
• 408: Kangpokpi
• 412: Noney
• 411: Pherzawl
• 403: Senapati
• 404: Tamenglong
• 407: Tengnoupal
• 405: Thoubal
• 406: Ukhrul

Meghalaya

• 424: East Garo Hills
• 418: East Jaintia Hills
• 414: East Khasi Hills
• 423: North Garo Hills
• 417: Ri-Bhoi
• 421: South Garo Hills
• 422: South West Garo Hills
• 415: South West Khasi Hills
• 420: West Garo Hills
• 416: West Jaintia Hills
• 419: West Khasi Hills

Mizoram

• 425: Aizawl East
• 426: Aizawl West
• 429: Champhai
• 428: Kolasib
• 432: Lawngtlai
• 431: Lunglei
• 427: Mamit
• 430: Serchhip
• 433: Siaha

Nagaland

• 434: Dimapur
• 444: Kiphire
• 441: Kohima
• 438: Longleng
• 437: Mokokchung
• 439: Mon
• 435: Peren
• 443: Phek
• 440: Tuensang
• 436: Wokha
• 442: Zunheboto

Odisha

• 445: Angul
• 448: Balangir
• 447: Balasore
• 472: Bargarh
• 454: Bhadrak
• 468: Boudh
• 457: Cuttack
• 473: Deogarh
• 458: Dhenkanal
• 467: Gajapati
• 449: Ganjam
• 459: Jagatsinghpur
• 460: Jajpur
• 474: Jharsuguda
• 464: Kalahandi
• 450: Kandhamal
• 461: Kendrapara
• 455: Kendujhar
• 446: Khurda
• 451: Koraput
• 469: Malkangiri
• 456: Mayurbhanj
• 470: Nabarangpur
• 462: Nayagarh
• 465: Nuapada
• 463: Puri
• 471: Rayagada
• 452: Sambalpur
• 466: Subarnapur
• 453: Sundargarh

Puducherry

• 476: Karaikal
• 477: Mahe
• 475: Puducherry
• 478: Yanam

Punjab

• 485: Amritsar
• 483: Barnala
• 493: Bathinda
• 499: Faridkot
• 484: Fatehgarh Sahib
• 487: Fazilka
• 480: Ferozpur
• 489: Gurdaspur
• 481: Hoshiarpur
• 492: Jalandhar
• 479: Kapurthala
• 488: Ludhiana
• 482: Mansa
• 491: Moga
• 486: Pathankot
• 494: Patiala
• 497: Rup Nagar
• 498: Sangrur
• 496: SAS Nagar
• 500: SBS Nagar
• 490: Sri Muktsar Sahib
• 495: Tarn Taran

Rajasthan

• 507: Ajmer
• 512: Alwar
• 519: Banswara
• 516: Baran
• 528: Barmer
• 508: Bharatpur
• 523: Bhilwara
• 501: Bikaner
• 514: Bundi
• 521: Chittorgarh
• 530: Churu
• 511: Dausa
• 524: Dholpur
• 520: Dungarpur
• 517: Hanumangarh
• 505: Jaipur I
• 506: Jaipur II
• 527: Jaisalmer
• 533: Jalore
• 515: Jhalawar
• 510: Jhunjhunu
• 502: Jodhpur
• 525: Karauli
• 503: Kota
• 532: Nagaur
• 529: Pali
• 522: Pratapgarh
• 518: Rajsamand
• 534: Sawai Madhopur
• 513: Sikar
• 531: Sirohi
• 509: Sri Ganganagar
• 526: Tonk
• 504: Udaipur

Sikkim

• 535: East Sikkim
• 537: North Sikkim
• 538: South Sikkim
• 536: West Sikkim

Tamil Nadu

• 779: Aranthangi
• 555: Ariyalur
• 578: Attur
• 565: Chengalpet
• 571: Chennai
• 778: Cheyyar
• 539: Coimbatore
• 547: Cuddalore
• 566: Dharmapuri
• 556: Dindigul
• 563: Erode
• 552: Kallakurichi
• 557: Kanchipuram
• 544: Kanyakumari
• 559: Karur
• 780: Kovilpatti
• 562: Krishnagiri
• 540: Madurai
• 576: Nagapattinam
• 558: Namakkal
• 577: Nilgiris
• 564: Palani
• 573: Paramakudi
• 570: Perambalur
• 575: Poonamallee
• 546: Pudukkottai
• 567: Ramanathapuram
• 781: Ranipet
• 545: Salem
• 561: Sivaganga
• 580: Sivakasi
• 551: Tenkasi
• 541: Thanjavur
• 569: Theni
• 554: Thoothukudi (Tuticorin)
• 560: Tiruchirappalli
• 548: Tirunelveli
• 550: Tirupattur
• 568: Tiruppur
• 572: Tiruvallur
• 553: Tiruvannamalai
• 574: Tiruvarur
• 543: Vellore
• 542: Viluppuram
• 549: Virudhunagar

Telangana

• 582: Adilabad
• 583: Bhadradri Kothagudem
• 581: Hyderabad
• 584: Jagtial
• 585: Jangaon
• 586: Jayashankar Bhupalpally
• 587: Jogulamba Gadwal
• 588: Kamareddy
• 589: Karimnagar
• 590: Khammam
• 591: Kumuram Bheem
• 592: Mahabubabad
• 593: Mahabubnagar
• 594: Mancherial
• 595: Medak
• 596: Medchal
• 612: Mulugu
• 597: Nagarkurnool
• 598: Nalgonda
• 613: Narayanpet
• 599: Nirmal
• 600: Nizamabad
• 601: Peddapalli
• 602: Rajanna Sircilla
• 603: Rangareddy
• 604: Sangareddy
• 605: Siddipet
• 606: Suryapet
• 607: Vikarabad
• 608: Wanaparthy
• 609: Warangal(Rural)
• 610: Warangal(Urban)
• 611: Yadadri Bhuvanagiri

Tripura

• 614: Dhalai
• 615: Gomati
• 616: Khowai
• 617: North Tripura
• 618: Sepahijala
• 619: South Tripura
• 620: Unakoti
• 621: West Tripura

Uttar Pradesh

• 622: Agra
• 623: Aligarh
• 625: Ambedkar Nagar
• 626: Amethi
• 627: Amroha
• 628: Auraiya
• 646: Ayodhya
• 629: Azamgarh
• 630: Badaun
• 631: Baghpat
• 632: Bahraich
• 633: Balarampur
• 634: Ballia
• 635: Banda
• 636: Barabanki
• 637: Bareilly
• 638: Basti
• 687: Bhadohi
• 639: Bijnour
• 640: Bulandshahr
• 641: Chandauli
• 642: Chitrakoot
• 643: Deoria
• 644: Etah
• 645: Etawah
• 647: Farrukhabad
• 648: Fatehpur
• 649: Firozabad
• 650: Gautam Buddha Nagar
• 651: Ghaziabad
• 652: Ghazipur
• 653: Gonda
• 654: Gorakhpur
• 655: Hamirpur
• 656: Hapur
• 657: Hardoi
• 658: Hathras
• 659: Jalaun
• 660: Jaunpur
• 661: Jhansi
• 662: Kannauj
• 663: Kanpur Dehat
• 664: Kanpur Nagar
• 665: Kasganj
• 666: Kaushambi
• 667: Kushinagar
• 668: Lakhimpur Kheri
• 669: Lalitpur
• 670: Lucknow
• 671: Maharajganj
• 672: Mahoba
• 673: Mainpuri
• 674: Mathura
• 675: Mau
• 676: Meerut
• 677: Mirzapur
• 678: Moradabad
• 679: Muzaffarnagar
• 680: Pilibhit
• 682: Pratapgarh
• 624: Prayagraj
• 681: Raebareli
• 683: Rampur
• 684: Saharanpur
• 685: Sambhal
• 686: Sant Kabir Nagar
• 688: Shahjahanpur
• 689: Shamli
• 690: Shravasti
• 691: Siddharthnagar
• 692: Sitapur
• 693: Sonbhadra
• 694: Sultanpur
• 695: Unnao
• 696: Varanasi

Uttarakhand

• 704: Almora
• 707: Bageshwar
• 699: Chamoli
• 708: Champawat
• 697: Dehradun
• 702: Haridwar
• 709: Nainital
• 698: Pauri Garhwal
• 706: Pithoragarh
• 700: Rudraprayag
• 701: Tehri Garhwal
• 705: Udham Singh Nagar
• 703: Uttarkashi

West Bengal

• 710: Alipurduar District
• 711: Bankura
• 712: Basirhat HD (North 24 Parganas)
• 713: Birbhum
• 714: Bishnupur HD (Bankura)
• 715: Cooch Behar
• 783: COOCHBEHAR
• 716: Dakshin Dinajpur
• 717: Darjeeling
• 718: Diamond Harbor HD (S 24 Parganas)
• 719: East Bardhaman
• 720: Hoogly
• 721: Howrah
• 722: Jalpaiguri
• 723: Jhargram
• 724: Kalimpong
• 725: Kolkata
• 726: Malda
• 727: Murshidabad
• 728: Nadia
• 729: Nandigram HD (East Medinipore)
• 730: North 24 Parganas
• 731: Paschim Medinipore
• 732: Purba Medinipore
• 733: Purulia
• 734: Rampurhat HD (Birbhum)
• 735: South 24 Parganas
• 736: Uttar Dinajpur
• 737: West Bardhaman

Daman&Diu

• 138: Daman
• 139: Diu

Himachal Pradesh

• 791: Chamba
• 795: Kangra
• 792: Kinnaur
• 793: Mandi
• 794: Shimla

Developer Todo

• Option to read config from a local file instead of cli args

Sample Notification on Phone