Ministry of Health and Family Welfare
Update on CoWIN
CoWIN launches new API: KYC-VS: Know Your Customer’s/Client’s Vaccination Status
KYC-VS will enable entities to check an individual’s status of vaccination through CoWIN
KYC-VS is consent-based, privacy preserving and can be seamlessly integrated with any system
Over 72 crore vaccine doses have been administered since the vaccination campaign against COVID-19 was flagged off on January 16 this year by Honourable Prime Minister Shri Narendra Modi. To provide a proof of vaccination for each of these individuals, Co-WIN is already issuing a digitally verifiable certificate. This certificate can be saved on a digital device  or stored in Digi Locker from where it can be digitally shared as and when required as a proof of vaccination. Similarly, at entry points where such certificate is required , it may be shown in both the digital and physical forms.
However, there may be instances where an entity does not need to see the certificate in full and would just need to know whether an individual has been vaccinated or not. A few of such possible use cases could be as follows:
- An enterprise/employer may like to know the vaccination status of its employees to resume functions in offices, workplaces etc.
ii) The Railways may want to get the status of vaccination of the passengers who are getting their seats reserved in the trains.
iii) Airlines may want to get the status of vaccination of the passengers who are booking their flight tickets, and/or airports may only want to allow vaccinated passengers to pass through.
iv) Hotels may want to know the vaccination status of the residents at the time they are checking into the hotel, or at the time of making online bookings.
As the socio-economic activities are being gradually revived while maintaining everyone’s safety, there is a need for a way to digitally convey the status of individuals’ vaccination to entities with whom they may be engaging with for any or all reasons, as employees, passengers, residents etc.
Therefore, there is a need to enable an Aadhaar like authentication service for the status of vaccination through Co-WIN. To take care of these cases and others that may come up, Co-WIN has developed a new API called ‘Know Your Customer’s/Client’s Vaccination Status’ or KYC-VS. To use this API, an individual needs to enter his/her mobile number and name. Thereafter, they will get an OTP which they have to enter. In return, Co-WIN will send a response to the verifying entity on the individual’s status of vaccination, which will be as follows –
0 - Person is not vaccinated
1 - Person is partially vaccinated
2 - Person is fully vaccinated
This response will be digitally signed and can be shared instantly with the verifying entity. A real-life example could be when at the time of booking a railway ticket, an individual will input the necessary details for buying the ticket and if required, the concerned entity will also get the vaccination status in the same transaction, with the due consent of the individual.
KYC-VS will facilitate all such use cases and more. It is both consent-based and privacy preserving. Additionally, in order to facilitate quick integration and faster adoption, the Co-WIN Team has prepared a webpage with the API, which may be embedded in any system. This will allow for a seamless integration with any system in no time.
Besides the use cases pointed out, this service may be utilized by any service provider, private or public, for whom verifying an individual’s vaccination status is critical for facilitating a service requested.