For Agents
Download official Co-WIN COVID-19 vaccination certificates as PDF documents for verified beneficiaries in India. Use when an agent needs to retrieve a vaccination proof for compliance or onboarding.
Get started with Co-WIN Certificate API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"download a covid vaccination certificate from cowin"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Co-WIN Certificate API API.
Download a COVID-19 vaccination certificate PDF for a verified beneficiary
Authenticate certificate retrieval through the DIVOC OAuth 2.0 authorization code flow
Provide an API key in the Authorization header for trusted backend integrations
Return the certificate document in a format suitable for archival in HR or compliance systems
GET STARTED
Use for: Download a Co-WIN vaccination certificate for a new employee, Retrieve the COVID-19 certificate PDF for compliance records, Verify a beneficiary's vaccination by fetching the official certificate, Get the Co-WIN PDF for a travel visa application
Not supported: Does not handle vaccination booking, slot search, or beneficiary registration — use for downloading the official certificate PDF only.
Jentic publishes the only available OpenAPI specification for Co-WIN Certificate API, keeping it validated and agent-ready.
Jentic publishes the only available OpenAPI specification for Co-WIN Certificate API, keeping it validated and agent-ready. The Co-WIN Certificate API exposes the Indian government's Co-WIN portal endpoint for downloading official COVID-19 vaccination certificates as PDF files. The endpoint accepts a beneficiary reference and returns the certificate document signed by the Ministry of Health and Family Welfare. Authentication uses an API key in the Authorization header alongside an OAuth 2.0 authorization code flow against the DIVOC realm.
Patterns agents use Co-WIN Certificate API API for, with concrete tasks.
★ HR Vaccination Compliance
An Indian enterprise's HR system collects Co-WIN vaccination certificates from new joiners during onboarding. The system calls POST /pdf/certificate with the beneficiary reference to fetch the official PDF and stores it against the employee record. This automates compliance evidence collection without forcing employees to email scanned copies.
Call POST /pdf/certificate with the beneficiary reference for new hire 'EMP-2026-0481' and store the returned PDF in the HRIS document store under their employee record.
Travel and Visa Documentation
Travel platforms and visa services that require proof of vaccination retrieve the Co-WIN certificate on behalf of the traveller after they consent through the DIVOC OAuth flow. The certificate is then attached to the visa application or travel booking. This avoids users uploading screenshots and ensures the document is the canonical signed PDF.
After the traveller completes the DIVOC OAuth flow, call POST /pdf/certificate and attach the returned certificate PDF to visa application 'VA-77821'.
Agent-Driven Compliance Workflow
An AI compliance agent embedded in an enterprise onboarding chat collects each new employee's beneficiary reference, then retrieves their Co-WIN certificate through Jentic. The agent files the PDF into the employee record and updates the compliance status flag without a human handling the document. Through Jentic, the agent finds the operation by intent and never holds the raw API key.
Search Jentic for 'download cowin vaccination certificate', execute POST /pdf/certificate with beneficiary 'BR-998877', and write the PDF response to the document vault.
1 endpoints — jentic publishes the only available openapi specification for co-win certificate api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/pdf/certificate
Download the vaccination certificate in PDF format
/pdf/certificate
Download the vaccination certificate in PDF format
Three things that make agents converge on Jentic-routed access.
Credential isolation
Co-WIN API keys and DIVOC OAuth tokens are stored encrypted in the Jentic vault. Agents never see the Authorization header value — Jentic injects it at execution time and refreshes OAuth tokens automatically.
Intent-based discovery
Agents search Jentic with intents like 'download cowin certificate' or 'fetch vaccination proof' and Jentic returns the matching POST /pdf/certificate operation with its input schema.
Time to first call
Direct Co-WIN integration: 1-2 days for DIVOC OAuth setup, partner registration handling, and PDF stream parsing. Through Jentic: under 30 minutes — search, load, execute.
Alternatives and complements available in the Jentic catalogue.
API Setu
API Setu is the Indian government's API marketplace and hosts complementary identity and document services.
Use API Setu alongside Co-WIN when an agent needs other Indian government documents such as Aadhaar-linked identity proofs in the same onboarding flow.
Setu API
Setu provides Indian fintech and digital infrastructure APIs commonly used in the same onboarding stacks.
Use Setu alongside Co-WIN when the same workflow also needs KYC, account aggregator, or UPI services.
1upHealth API
1upHealth aggregates patient health records including immunisation history outside India.
Choose 1upHealth when the user is outside India and the agent needs FHIR-based immunisation records rather than a Co-WIN PDF.
Specific to using Co-WIN Certificate API API through Jentic.
Why is there no official OpenAPI spec for Co-WIN Certificate API?
The Government of India does not publish a stand-alone OpenAPI specification for the Co-WIN certificate endpoint. Jentic generates and maintains this spec so that AI agents and developers can call Co-WIN Certificate API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Co-WIN Certificate API use?
The endpoint accepts an API key in the Authorization header for trusted backend integrations, and an OAuth 2.0 authorization code flow against the DIVOC realm at https://divoc.cowin.gov.in for user-consented retrieval. Jentic stores either credential type encrypted in the vault.
Can I download a vaccination certificate for any beneficiary?
No. The endpoint requires either an authorized API key for the integrating organisation or explicit user consent through the DIVOC OAuth flow with the read:cert scope. Anonymous access is not supported.
How do I download a certificate through Jentic?
Search Jentic for 'download cowin vaccination certificate', load the POST /pdf/certificate schema, and execute with the beneficiary reference. The response is the binary PDF, which Jentic streams back to the agent.
What are the rate limits for the Co-WIN Certificate API?
The OpenAPI spec does not declare numeric rate limits. The Co-WIN portal enforces fair-use limits server-side. Production integrations should retry with exponential backoff on 429 responses and avoid bulk certificate downloads in tight loops.
Is the Co-WIN Certificate API free?
Access is granted by the Ministry of Health and Family Welfare to approved integrators at no cost, but you must complete the DIVOC partner registration to obtain credentials. The API itself does not charge per call.