cowin-checker 💯💉

TL;DR This script automates the tedious process of looking for open slots in multiple locations. It filters and shows available slots for a given pincode or district upto 3 days. It is targeted at technical folks who want to monitor Cowin for their non-technical loved ones.

Story

By sheer luck I was able to book an appointment for my first dose. Many of my friends and relatives have been trying for days but couldn't book their slots before it got over in minutes. I had nothing to tell them than that I will keep looking and let them know if I find anything.

So I started checking once in a while, but the Cowin website does not have a great UX. It does most things decently, but doesn't do some basic things such as filtering out or sorting so that available centers would be shown first. This means that for every lookup we have to spend time scrolling through the list to find open slots.

I had a few people from different parts of India who needed vaccines, and if I wanted to look for all of them, it would take a considerable amount of time, not to mention I have to keep in mind the exact requirements for each person and do the filtering in my head.

That's why I came up with this, spent an evening and this is the result so far. My vision for this is for it to be a useful tool for any developer to support their loved ones who are looking for vaccine slots, while not being a big time sink. UX is a priority and we might see a better cli for adding and managing requirements.🥳

Sooo that's it. If you like it hit the star so you can find it again easily. If you used this and it helped you find a slot for your loved ones, please write about your experience in the issues section!! ❤️ If you think anything needs improvement, feel free to create an issue and we can discuss on it. If anyone wants to contribute to the code, they are most welcome to, after discussing on the issues list.❤️

Initial setup

If you don't have Node.js installed already, please follow any article on google on how to do that.

Then install dependencies using

npm install

Then open the config.js file and modify the locations array as per your requirements. For the type field, you can use "district" or "pincode" as shown below. Then correspondingly provide the districtId or pincode. Give a suitable title to identify each location in the output. Filters are explained in the next section below.

locations: [
    {
      type: "district",
      districtId: 304,
      title: "Kottayam, Kerala",
      filters: [available, covaxin, above18]
    },
    {
      type: "pincode",
      pincode: 382475,
      title: "Hansol (382475)",
      filters: [available]
    },
  ]

Filters

Filters can be used to setup rules to filter each location request. The items in the array are applied in an AND fashion. e.g. [available, covaxin, above18] means available and covaxin and above18. Code for filters is in filters.js and it is straightforward. Listing them here,

available
dose1
dose2
above18
above45
covishield
covaxin

Running

Run the script using node index.js. Note that the script does not auto refresh, you will need to re-run to get latest data.

Improvements

Search for multiple days (for 3 days now)
Modular and dynamic filters
Split code into smaller modules

District ID Lookup

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

Steps To Run the project from your mobile phone

You can run the project in your mobile phone as well. You do this by basically first installing a terminal emulator and then then executing the project from the terminal. the steps are:

Steps

Install f-Droid app from f-Droid. In the world of opensource apps, this one acts as the manager. Meaning that it'll help you to install the correct version of an opensource app that's compatible with your phone. It's kinda like the playstore for opensource apps.
Install Termux app from f-Droid Easy enough step. Do take care that u don't download or update this app from playstore.
Open the Termux app and type in "pkg update && pkg upgrade" This ensures that the packages are uptodate.execute this as often as you like and esp. after installing a new package.
Now terminal is ready. To install cowin-checker, execute "pkg install node","pkg install git"
Execute "git clone https://github.com/johnjacobkenny/cowin-checker.git"
Execute "cd cowin-checker"
Execute "npm install"
Execute "node index.js". the results will show up on the screen.
If you want to see the files in Termux, you need a special file explorer app (If phone is not rooted). For more on that https://wiki.termux.com/wiki/Sharing_Data Google "Termux sharing","File Explorer",etc

Notes:

If there is any package that I forgot to mention, or is needed for you , Termux will ask you to install it and give you the commands to do just that. Its very friendly like that.
There are a lot of tutorials available in youtube for Termux. You can use that if you run into issues. But don't blindly run any code that they say as there a lot of malicious "tutorials" targeting Termux noobies.

johnjacobkenny / cowin-checker