# Distributing a DIVOC Certificate

## Purpose 

The purpose of this document is to outline the features of DIVOC's certificate distribution service.

## **Overview**

* DIVOC offers several ways in which countries can distribute certificates at scale. 
* The platform is designed to facilitate multiple certificate distribution methods, which includes:

      \- Printed paper certificate with QR code.

      \- Digital certificate distribution - download and share QR code via URL link, email  attachments, smartphone with user authentication.

      \- By integrating with a country's vaccination portal, health wallets, PHR, consumer, or travel applications.

      \- Countries can also distribute certificates for a health event via DIVOC’s Citizen Portal.

![](https://3849653046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Frmjx4OUiHEx18PH4nMzn%2Fuploads%2FOsVEPEFYqKDwWxMSVYwR%2FScreenshot%202022-03-25%20at%201.05.17%20PM.png?alt=media\&token=c8651721-1ee1-4e1f-aaa0-e3192c1e751b)

* After a health event such as vaccination, citizens can log in to the Citizen Portal with their registered mobile number, and they are given the option to securely download the certificate in PDF or other formats with added user authentication.
* If using DIVOC’s citizen portal, the home screen of the Citizen Portal has a “Download” button in the “Download your Vaccination Certificate” section.  Citizens can click the button and they will be asked to log in using their registered mobile number to download the certificate. To understand how it works, you can check our demo section on [**downloading certificates**](https://divoc.egov.org.in/divoc-demo/citizen-portal#2.-for-downloading-a-certificate).

## Certificate API 

The DIVOC certificate distribution service provides a get API so that certificates can be downloaded or printed for specific events. For fetching the right certificate, the get service requires a “pre-enrollment code,” and the latest certificate is fetched.

### **How does it work?**

* The get certificate receives the preEnrollmentCode (beneficiary id) as input: 

{% hint style="info" %}
GET {domain}/certificate/api/certificatePDF/{beneficaryId}
{% endhint %}

* Once it receives the input, it,

1. gets all certificates associated with preEnrollmentCode from the database.
2. gets the latest dose certificate by grouping the certificates by dose, and order\
   them by their timestamps.
3. creates the QR code from signed certificate data.
4. using the above-generated QR code and certificate information, it creates a PDF.

* Similarly, there are APIs in certificate-api service which can return the QR code as a png image, which follows the same step as above (till the third point):

{% hint style="info" %}
GET /certificate/api/certificateQRCode/{beneficaryId}
{% endhint %}

* We also have an API to check if a beneficiary has a certificate generated, which follows the same step as above (till the second point):

{% hint style="info" %}
HEAD  {domain}/certificate/api/certificatePDF/{beneficaryId}
{% endhint %}

[![Creative Commons License](https://i.creativecommons.org/l/by/4.0/80x15.png)](http://creativecommons.org/licenses/by/4.0/)*All content on this page by* [*eGov Foundation*](https://egov.org.in/) *is licensed under a* [*Creative Commons Attribution 4.0 International License*](http://creativecommons.org/licenses/by/4.0/)*.*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://divoc.digit.org/platform/divocs-verifiable-certificate-features-2.0/distributing-a-divoc-certificate.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.