Integration Guides

ABDM Integration Guide for Hospital Software

What ABDM integration involves for a hospital system or health app: ABHA, the HIP and HIU roles, consent, FHIR records, registries and what to build in each layer.

Purushottam Kumar Suman
Purushottam Kumar Suman
Founder & CEO, Drema AI
9 min read
Healthcare IT systems in a hospital

The Ayushman Bharat Digital Mission is a set of shared digital rails for health: an ID for each person, registries of facilities and professionals, and a consent-based way to exchange health records between any two systems. Integrating a hospital system with ABDM means your software can create and verify ABHA numbers, publish the records it holds and, with consent, fetch records held elsewhere.

01

The building blocks

Five terms cover most of what you need.

ABHAAyushman Bharat Health Account: a 14-digit number and an optional ABHA address that identify a person across systems
HFR and HPRThe Health Facility Registry and Healthcare Professionals Registry, where hospitals and doctors are registered
HIPHealth Information Provider: a system that holds records and shares them, such as a hospital, lab or clinic
HIUHealth Information User: a system that requests records with the patient's consent
PHR app and consent managerThe patient's app for linking records and approving or denying consent requests
02

The three milestones

NHA structures integration into milestones. Each is tested separately in the sandbox.

M1
Create and verify ABHA; capture it at registration
M2
Act as HIP: link care records to ABHA and share them on consent
M3
Act as HIU: request, receive and display records with consent
03

What M1 looks like in the product

M1 changes the registration desk.

Scan and share is the feature front-desk staff notice: registration without typing.

ABHA creationUsing Aadhaar OTP or other supported methods, from the registration screen
ABHA verificationFor patients who already have one, by OTP or other supported authentication
Scan and shareThe patient scans the facility's QR code in a PHR app and their profile arrives at the desk, creating a token
Profile mappingABHA details mapped to your patient master without creating duplicates
04

What M2 looks like

As a HIP, your system tells ABDM that records exist for a patient and hands them over when a valid consent arrives. Records are grouped into care contexts, such as a visit or an admission, and linked to the patient's ABHA address.

Care context linkingInitiated by the hospital after a visit, or discovered by the patient from their app
FHIR bundlesRecords generated as FHIR R4 documents in ABDM's profiles: prescription, diagnostic report, OP consultation, discharge summary, immunisation record, health document, wellness record and invoice
Consent notification handlingStore consent artefacts and honour their scope, date range and expiry
Encrypted transferData encrypted for the requesting HIU and pushed to its data endpoint
05

What M3 looks like

As an HIU, a doctor in your system can ask for a patient's past records. The request names the purpose, record types, date range and how long access is needed. The patient approves in their PHR app, your system receives the artefact, fetches data from each HIP, decrypts it and shows it in the clinical screen. Access ends when the consent expires or is revoked.

06

Engineering notes

Teams new to ABDM underestimate a few things.

Asynchronous APIsMost calls go through a gateway and return through callbacks to your registered endpoints; you need public, reliable callback URLs
Mapping to FHIRYour internal data model has to map to FHIR resources with standard codes; plan this early
EncryptionKey exchange and encryption for health data transfer follow ABDM's specification; use tested libraries
VersionsAPI versions change; build an integration layer that isolates the rest of the system
Multiple facilitiesEach facility needs its HFR ID and is registered as a service under your bridge
Bridge and callback URLsFHIR mapperConsent storeCare context tableAudit logRetry and idempotency
07

Why integrate

Beyond patient convenience, ABDM integration is increasingly expected in government empanelment and insurance processes, and NHA has run a Digital Health Incentive Scheme rewarding facilities and software companies for linked records. Check NHA's current notices for scheme status. The path from sandbox to production, including testing and the security audit, is covered in our companion guide on milestones.

Sources · last reviewed October 1, 2026

This article explains what to build, not legal advice. Rules change; confirm against the current official text before relying on it.

Purushottam Kumar Suman
Written by
Purushottam Kumar Suman
Founder & CEO, Drema AI

Founder and CEO of Drema AI. Builds AI systems, SaaS platforms and industry software — and writes about what actually survives production.

CTA Background

Got a problem like this one?

Bring it to a call with a founder.You will get a straight answer, including when the answer is no.

View Our Work
AI-First Engineering
Secure & Scalable
Built to Deliver Impact