Covid Vaccine Availability Dashboard

From May 1st, the government of India has opened several vaccination centers for people aged between 18 to 45. The vaccines are scarce and logging into Cowin app to check status is cumbersome due to frequent timeouts. The government has also made a public API to access vaccine related information like finding availability and downloading vaccination certificates. Using this, I have made a dashboard that makes it easy to find vaccine availability by district or pincode.

Dashboard Demo

This dashboard is made with Angular web framework and Angular Material for components.

View full page demo | View repo on github

Cowin APIs

The APIs have the general pattern: BASE_URL + PATH + PARAMETERS
where BASE_URL is cdn-api.co-vin.in/api/v2/appointment/sessions/public/

For finding list of states and districts with their ids use BASE_URL as cdn-api.co-vin.in/api/v2/admin/location/

These APIs can be accessed directly through a browser, REST clients like Postman, or any programming language.

Python

Requests is one of the python libraries for making HTTP calls, with steps being as simple as:

1. Import library: import requests
2. Make the GET call response = requests.get("https://cdn-api.co-vin.in/api/v2/admin/location/states")
3. Check the status (200 = successful) print(response.status_code)
4. Show the response print(response.json())

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

import requests
import json

# Appointment availibility by district and date (18+)
url = "https://cdn-api.co-vin.in/api/v2/appointment/sessions/public/findByDistrict"
params = {"district_id": "365", "date": "25-05-2021"}
response = requests.get(url, params=params)
print("HTTP ", response.status_code)
data = response.json()
for session in data["sessions"]:
    if session["min_age_limit"] == 18:
        print(json.dumps(session, indent=2))

# Appointment availibility by district for (18+) for next 7 days
url = "https://cdn-api.co-vin.in/api/v2/appointment/sessions/public/calendarByDistrict"
params = {"district_id": "365", "date": "25-05-2021"}
response = requests.get(url, params=params)
print("HTTP ", response.status_code)
data = response.json()
for center in data["centers"]:
    for session in center["sessions"]:
        if session["min_age_limit"] == 18 and session["vaccine"]=="COVISHIELD" and session["available_capacity"] > 0:
            print(json.dumps(session, indent=2))

JavaScript

XMLHttpRequest is a built-in object in JavaScript that can make HTTP calls in simple steps:

1. Instantiate the object var request = new XMLHttpRequest()
2. Prepare the GET call request.open('GET', 'https://cdn-api.co-vin.in/api/v2/appointment/sessions/public/findByDistrict?district_id=365&date=25-05-2021')
3. Define a function to do something when the response is received request.onload = function () {
console.log(request.status); console.log(this.response); }
4. Make the GET call request.send()

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

// Appointment availibility by date and district
var request = new XMLHttpRequest();        
request.open('GET', 'https://cdn-api.co-vin.in/api/v2/appointment/sessions/public/findByDistrict?district_id=365&date=25-05-2021');

request.onload = function () {               
    console.log(request.status);
    console.log(this.response);
}

request.send()  

References

• Cowin API documentation by GoI
• Making HTTP requests in Python
• Making HTTP requests in JS (or TS)
• Getting started with Angular
• Getting started with Angular Material