National Health AuthorityNHA Docs

Command Palette

Search for a command to run...

Milestone 2 — HIP Data Sharing

Implement the HIP role, link care contexts, and share encrypted FHIR records after patient consent.

Milestone 2 makes your system a Health Information Provider (HIP). Create patient records, link them to an ABHA, and share them after consent.

Scope

Act as the HIP for each registered facility.

  • Create health records in ABDM FHIR R4 format.
  • Group records into clear care contexts.
  • Link each care context to the patient's ABHA.
  • Support user-initiated Discovery & Link.
  • Accept health information requests after consent.
  • Encrypt FHIR bundles and push them to the HIU.
  • Send status notifications to HIE-CM.

Prerequisites

Before you start Milestone 2, complete these tasks.

PrerequisiteWhy it matters
Facility IDHIE-CM routes HIP calls to this facility.
HIP role registrationABDM authorizes the bridge to link and share records.
Bridge callback URLHIE-CM sends discovery, link, consent, and data requests to this URL.
Gateway access tokenYour HIP calls HIE-CM APIs with this bearer token.
FHIR bundle generatorThe HIP must build NRCeS-conformant FHIR R4 documents.
Encryption implementationThe HIP must encrypt each health data payload for the HIU.

Health record formats

The source states that HRP/HIP systems can link only these health records. All health records must use the NRCeS ABDM FHIR R4 profiles.

Health record typeUse
Diagnostic Report RecordShare laboratory and radiology reports.
Discharge Summary RecordShare a discharge summary for an inpatient admission.
Health Document RecordShare unstructured documents, scans, or PDFs.
Immunization RecordShare vaccines, certificates, and next-dose advice.
OP Consult RecordShare outpatient notes, examinations, medicines, and advice.
Prescription RecordShare medication advice that follows PCI guidance.
Wellness RecordShare vitals, examination data, and wellness data.
Invoice RecordShare billing details, pharmacy invoices, and consultation invoices.

HMIS HI types

The source states that HMIS implementations must implement all listed HI types. Confirm your declared HI types during ABDM certification.

Care contexts

A care context is a reference to a logical group of records. Use one care context per OPD visit or IPD admission.

HIE-CM remains data-blind. It stores only identifiers and metadata for each care context. It does not store the clinical record.

ComponentRule
Reference IDUse a unique ID from the HIP system.
Display nameUse a clear label that helps the patient select records.
Sensitive dataDo not include diagnoses, results, or confidential data.
Care context shape
{
  "patient": {
    "referenceNumber": "TMH-PUID-001",
    "display": "TMH records for Kiran Kumar",
    "careContexts": [
      {
        "referenceNumber": "VISIT-2375639",
        "display": "OPD records for 03 Oct 2022"
      }
    ]
  }
}

Milestone 2 implementation guides

Certification scenarios

Prepare these scenarios before Milestone 2 certification.

  • Link a new care context with a valid link token.
  • Reject a link request when the link token is invalid or expired.
  • Return only unlinked records during Discovery & Link.
  • Complete link init and link confirm with OTP validation.
  • Receive a granted consent artefact and acknowledge it.
  • Reject data requests outside the consent date range.
  • Build valid FHIR bundles for each declared HI type.
  • Encrypt each bundle and push it to the HIU data push URL.
  • Send transfer notifications with success and failure states.

Sources

  • ABDM Proposed Simplified Milestone 2 (DOCX→MD, 2026-08)