Back to BlogDigital Health

ABDM FHIR Integration Guide 2026: How to Make Your HMS ABDM Compliant

February 19, 2026 16 min read

India's ABDM framework uses HL7 FHIR R4 as the standard for health data exchange. Whether you're an HMS vendor, hospital IT team, or integration partner — this technical guide walks you through the complete ABDM FHIR integration process, from sandbox to production.

ABDM FHIR Integration Architecture for Indian Hospitals

ABDM Architecture Overview

Understanding the key components is essential before integration:

ABDM aims to create digital health records for 1.4 billion Indians by 2030.

Over 45 crore ABHA IDs have been created as of March 2026.

Adrine ABDM Control Center - ABHA registrations, linked records, and M3 compliance status

ABDM Control Center showing ABHA registrations, linked health records, and M1-M3 compliance badges

  • ABHA (Ayushman Bharat Health Account): Patient's unique digital health ID
  • HFR (Health Facility Registry): Registry of all healthcare facilities
  • HPR (Healthcare Providers Registry): Registry of verified doctors and healthcare workers
  • HIP (Health Information Provider): Entities that create health records (hospitals, labs)
  • HIU (Health Information User): Entities that consume health records (with consent)
  • Consent Manager: Manages patient consent for data sharing
  • Gateway: Central routing service connecting HIPs and HIUs

ABDM Integration Milestones

MilestoneAPIs RequiredFHIR ResourcesEffort
M1: RegistrationABHA creation, HFR, HPRPatient, Practitioner, Organization2-4 weeks
M2: Health Record LinkingDiscovery, Link, Care ContextEncounter, DiagnosticReport, MedicationRequest4-8 weeks
M3: Consent & Data ExchangeConsent, Data TransferBundle, DocumentReference, Composition6-12 weeks

M1: ABHA Registration Integration

M1 is the foundation — creating and verifying ABHA IDs during patient registration.

Key APIs

  • Create ABHA: Generate new ABHA ID using Aadhaar or mobile
  • Verify ABHA: Authenticate existing ABHA using OTP
  • Link ABHA: Link ABHA to your hospital's patient record
  • HFR Registration: Register your facility on Health Facility Registry
  • HPR Verification: Verify doctors against Healthcare Providers Registry

FHIR Resources Used

  • Patient: Demographics, ABHA ID, contact information
  • Practitioner: Doctor details, HPR ID, specialization
  • Organization: Hospital details, HFR ID, address

M2: Health Record Linking

M2 enables patients to discover and link their health records from your hospital to their ABHA account.

Discovery Flow

  1. Patient requests record discovery from PHR app
  2. ABDM gateway sends discovery request to your HMS (HIP)
  3. Your HMS searches for matching patient records
  4. Returns list of available care contexts (visits, admissions)
  5. Patient selects and links desired records

Care Contexts

Each visit/admission creates a "care context" that can be linked. Types include:

  • OPD Consultation
  • IPD Admission
  • Lab Investigation
  • Pharmacy Prescription
  • Discharge Summary

M3: Consent-Based Data Exchange

M3 is the most complex milestone — implementing consent management and actual health data sharing using FHIR bundles.

Consent Flow

  1. HIU (requesting hospital) initiates consent request through consent manager
  2. Patient receives consent notification on PHR app
  3. Patient reviews and grants/denies consent
  4. Consent artifact is created and signed
  5. HIU requests health data from HIP (your hospital)
  6. HIP validates consent and sends encrypted FHIR data
  7. HIU decrypts and displays the health records

FHIR Document Types

Document TypeFHIR CompositionKey Resources
OPD RecordOPVisitRecordEncounter, Condition, MedicationRequest
Discharge SummaryDischargeSummaryEncounter, Procedure, CarePlan
PrescriptionPrescriptionRecordMedicationRequest, Dosage
Lab ReportDiagnosticReportRecordDiagnosticReport, Observation
Health DocumentHealthDocumentRecordDocumentReference, Binary

Testing in ABDM Sandbox

NHA provides a sandbox environment for testing before going to production:

  • Sandbox URL: sandbox.abdm.gov.in
  • Test ABHA IDs: Pre-generated test accounts for development
  • Postman Collections: NHA provides Postman collections for all APIs
  • PHR App: Sandbox version of PHR app for consent testing
  • Validation: Automated test cases for milestone compliance verification

Common Integration Challenges

ChallengeSolution
FHIR mapping from existing EMRCreate mapping middleware between your data model and FHIR resources
Consent callback handlingImplement async webhook handlers with retry logic
Data encryptionUse NHA's encryption library (ECDH + AES-GCM)
Aadhaar OTP failuresImplement mobile-based ABHA creation as fallback
Gateway timeoutImplement proper timeout handling and retry queues

Frequently Asked Questions

Do I need to build ABDM integration from scratch?

No. You have three options: (1) use an HMS like Adrine that has pre-built ABDM integration, (2) use a third-party technical integrator, or (3) build it yourself using NHA's API documentation. Option 1 is the fastest and cheapest.

What FHIR version does ABDM use?

ABDM uses HL7 FHIR R4 (Release 4) with India-specific profiles. The profiles define which FHIR resources and extensions are required for Indian healthcare data exchange.

Related Articles

Skip the Integration Hassle

Adrine comes with pre-built ABDM FHIR integration — M1, M2, M3 ready. No API development needed. Go live in weeks, not months.

Book Free Demo