📋 OpenAPI v3.1 Fully Compliant

DISHA 4.0 HCOS Core OpenAPI v3.1 Specification & API Reference

Explore the standardized REST and GraphQL endpoints powering decentralized identity verification, CEL audit logging, ZK-proof generation, and automated financial disbursals.

✅OpenAPI v3.1Fully Compliant Schema Definitions

⚡< 50msGlobal P99 Verification API Latency

🔐Stage 1–5End-to-End Cryptographic Endpoint Coverage

API Architecture & Integration Modules

Three core API module groups expose the full HCOS pipeline to external integrators.

🪪Stage 1 PIL

Sovereign Identity & PIL Endpoints

/v1/identity

Issue, resolve, and manage decentralized identifiers (DIDs) and credential schemas for individuals and institutions.

✓DID issuance & resolution
✓Key rotation contracts
✓Credential schema registry
✓PIL anchor verification

📒Stage 2 CEL

Ledger & CEL Audit Endpoints

/v1/ledger

Query immutable activity blocks, micro-credential completions, and timestamped assessment hashes from the Cryptographic Event Ledger.

✓Immutable block queries
✓Merkle proof retrieval
✓Certificate hash validation
✓Timestamped audit trails

🔐Stage 5 ZKPG

ZK Proof & Underwriting Endpoints

/v1/underwriting/verify

Submit zero-knowledge verification requests for financial risk modeling and instant eligibility checks without exposing raw PII.

✓ZK-SNARK proof submission
✓Eligibility threshold checks
✓Privacy-preserving assertions
✓Lender API integration

HCOS Stage 1–5 API Layer Mapping

Multi-stage technical architecture exposed through the OpenAPI specification.

Stage 1PIL

DID Resolution & Key Rotation

/v1/identity/did:disha

Sovereign identity anchor for all HCOS participants. The PIL endpoint handles DID issuance, resolution, and cryptographic key rotation contracts for individuals and institutions.

Stage 2CEL

Tamper-Proof Certificate Validation

/v1/cel/verify-proof

Verify-proof endpoint validates micro-credential completions and timestamped assessment hashes against the immutable Cryptographic Event Ledger.

Stage 5ZKPG

Privacy-Preserving Attribute Assertion

/v1/zk/verify

The ZK verify endpoint receives zero-knowledge inputs for privacy-preserving attribute assertions — enabling financial eligibility checks without exposing raw student data.

Interactive OpenAPI Spec & API Code Sandbox

Explore schema definitions, generate code snippets, and inspect the raw specification.

API ROUTES

POST/v1/identity/did:disha

Issue a new Decentralized Identifier (DID)

PARAMETERS

Name	Type	Required	Description
learnerId	string	required	Unique learner identifier
credentialSchema	string	required	Schema URI for credential type
proofType	string	optional	ZeroKnowledge \| Standard

RESPONSES

200 OKDID successfully issued with cryptographic proof

401 UnauthorizedInvalid or expired API key

422 UnprocessableInvalid schema or malformed request body

Developer Experience & Architect Testimonials

Feedback from Chief Architects, Lead Integration Engineers, and Fintech CTOs.

“The OpenAPI 3.1 spec is the cleanest I've reviewed in five years of fintech integrations. Schema contracts are precise, versioned, and the ZK endpoint documentation is genuinely groundbreaking.”

Arjun Mehta

Chief Architect, NeoFinance Technologies

“We integrated the HCOS identity and ledger endpoints in under 48 hours. The TypeScript SDK types are perfectly aligned with the spec — zero guesswork, zero runtime surprises.”

Priya Nair

Lead Integration Engineer, EduStack Platforms

“As a fintech CTO, I've seen hundreds of API specs. DISHA's OpenAPI 3.1 documentation sets a new benchmark — especially the ZK proof endpoint coverage and the privacy-preserving underwriting flows.”

Vikram Sinha

CTO, CredBridge Fintech

“The interactive Swagger-style documentation made onboarding our backend team trivial. The response schema contracts are immutable and versioned — exactly what enterprise integrations demand.”

Dr. Ananya Krishnan

VP Engineering, SkillBridge Global

“DISHA's CEL audit endpoint documentation is exceptional. Every field is annotated, every error code is documented with resolution steps. This is what developer-first API design looks like.”

Rahul Desai

Senior Backend Engineer, GovTech Solutions India

“The raw YAML spec download was immediately importable into our internal API gateway. No modifications needed. The schema definitions are production-grade from day one.”

Meera Pillai

Platform Architect, Axis Capital Ventures

🔑 Developer Credentials & Sandbox Access

Request Sandbox API Keys

Get immediate access to the DISHA 4.0 HCOS sandbox environment with full OpenAPI 3.1 spec coverage.