cowin

Cowin NodeJS wrapper

Usage no npm install needed!

<script type="module">
  import cowin from 'https://cdn.skypack.dev/cowin';
</script>

README

Cowin

A NodeJS wrapper of Cowin Public API. We can win Covid 🤝

Installation:

npm install cowin

Available methods:

  • getState - Get all states in India
  • getListofDistricts - Get get all the districts of state
  • findByPin - Get planned vaccination sessions on a specific date in a given pin
  • findByDistrict - Get planned vaccination sessions on a specific date in a given district
  • calendarByPin - Get planned vaccination sessions for 7 days from a specific date in a given pin,
  • calendarByDistrict - Get planned vaccination sessions for 7 days from a specific date in a given district

Referred to Cowin API Docs for more details.

Usage:

  • Import required modules
const {
    getStates,
    getListofDistricts,
    findByPin,
    findByDistrict,
    calendarByPin,
    calendarByDistrict
} = require('cowin')
  • Write asynchronous function
async function fireitup() { /* asynchronous */

    const allstates = await getStates()
    console.log(allstates)

    const alldistricts = await getListofDistricts(36) /* { state_id } */
    console.log(alldistricts)

    const calenderbypin = await calendarByPin(731204, '13-05-2021') /* { pincode, date } */
    console.log(calenderbypin)

    const calenderbydistrict = await calendarByDistrict(713, '13-05-2021') /* district_id, date */
    console.log(calenderbydistrict)

    const findbypin = await findByPin(731204, '13-05-2021') /* { pincode, date } */
    console.log(findbypin)

    const findbydistrict = await findByDistrict(713, '13-05-2021') /* district_id, date */
    console.log(findbydistrict)

}

fireitup()
  • Response will looks like
{
    status: true,
    result: [/* Results */]
}
  • Exception handling
{
    status: false,
    message: "Sorry that's an error"
}

Limitation:

APIs are subject to a rate limit of 100 API calls per 5 minutes per IP

Crafted with care by Tuhin 💗