Co-WIN Certificate API

Name: Co-WIN Certificate API API
Brand: Co-WIN Certificate API
Availability: InStock

★ Only Publicly Available SpecHealthcareEhr EmrapiKey, oauth21 EndpointsREST

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.

Quickstart

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.

Capabilities

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

Start building with Co-WIN Certificate API API

Explore with Jentic

View OpenAPI Spec

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.

★ 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.

Key Endpoints

1 endpoints — jentic publishes the only available openapi specification for co-win certificate api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/pdf/certificate

Download the vaccination certificate in PDF format

POST

/pdf/certificate

Download the vaccination certificate in PDF format

Why though Jentic?

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.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

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.

Complementary

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.

Alternative

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.

FAQs

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.