Ndhm Health Repository Provider Specifications for HIP

Name: Health Repository Provider Specifications for HIP API
Brand: Health Repository Provider Specifications for HIP
Availability: InStock

Browse all Ndhm APIs

★ Only Publicly Available OpenAPI DocumentHealthcareEhr Emrnone30 Endpoints

Install Jentic One Beta

Connect the Health Repository Provider Specifications for HIP to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Health Repository Provider Specifications for HIP, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Health Repository Provider Specifications for HIP API.

Respond to patient discovery via /v0.5/care-contexts/on-discover with matching encounters

Link patient care contexts using /v0.5/links/link/init and /v0.5/links/link/confirm

Receive consent grant and revoke notifications at /v0.5/consents/hip/on-notify

GET STARTED

Start building with Health Repository Provider Specifications for HIP API

Explore with Jentic

View OpenAPI Document

For Agents

Implement and call the Health Information Provider side of NDHM - discover patients, link care contexts, receive consent notifications, and transfer encrypted health records.

Use for: I need to respond to a patient discovery request from the NDHM Gateway, Link a new care context for an admitted patient, Acknowledge a health information request from an HIU, Transfer an encrypted FHIR bundle to an HIU

Not supported: Does not issue consent artefacts, ABHA identifiers, or payments - use for the NDHM HIP record-serving role only.

Jentic publishes the only available OpenAPI specification for Health Repository Provider Specifications for HIP, keeping it validated and agent-ready. This specification covers the endpoints a Health Information Provider must implement and call to participate in India's NDHM network as a record-holding party - typically a hospital, lab, or clinic. The 30 endpoints cover discovery callbacks, care-context linking, consent notification, encrypted health information transfer, and Gateway-facing helpers such as the certs and OpenID configuration. It is the producer side of the NDHM data flow.

Use Cases

Patterns agents use Health Repository Provider Specifications for HIP API for, with concrete tasks.

★ Hospital HIP Onboarding

A hospital implementing HIP responsibilities under NDHM exposes the discovery, link, consent, and data-transfer callbacks defined in this specification. When the Gateway broadcasts a discovery for a patient, the hospital responds with matching encounters, then handles the consent notification and serves the encrypted FHIR bundle on transfer. End-to-end onboarding takes 4-8 weeks of integration plus NHA certification.

POST /v0.5/care-contexts/on-discover with matching encounters for the patient identifiers received in the discovery callback.

Care Context Linking After Discharge

After a patient is discharged, the hospital initiates HIP-side care-context linking so future consent flows can target the encounter. The HIP calls /v0.5/links/link/add-contexts on the Consent Manager and handles the on-confirm callback locally. Once linked, the encounter becomes discoverable and shareable under the patient's ABHA id.

POST /v0.5/links/link/add-contexts with the patient ABHA id, the new encounter references, and the HIP's identifier.

Consent-Bound Record Transfer

When an HIU presents a granted consent artefact, the Gateway forwards a /v0.5/health-information/hip/request to the HIP. The HIP validates the consent artefact, packages the requested records as an encrypted FHIR bundle, acknowledges via /v0.5/health-information/hip/on-request, and transfers the bundle to the HIU via /v0.5/health-information/transfer. The whole flow is async and bound to the consent's validity window.

Validate the incoming consent artefact, then POST /v0.5/health-information/transfer with the encrypted FHIR bundle, key material reference, and the transaction id.

Agent-Driven HIP Operations

An AI agent embedded in a hospital information system uses Jentic to handle NDHM HIP callbacks without rebuilding the request signing and routing scaffolding. The agent searches for the right operation, loads the schema, and submits responses to discovery, link, and transfer events while Jentic manages the participant credentials.

Search Jentic for 'transfer encrypted health information from HIP', load the schema for /v0.5/health-information/transfer, and execute it with the encrypted bundle.

Key Endpoints

30 endpoints — jentic publishes the only available openapi specification for health repository provider specifications for hip, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/v0.5/care-contexts/on-discover

Respond to patient care-context discovery

POST

/v0.5/links/link/init

Initiate care-context linking

POST

/v0.5/links/link/confirm

Confirm care-context linking

POST

/v0.5/links/link/add-contexts

Add new care contexts for a patient

POST

/v0.5/consents/hip/on-notify

Receive consent notification on HIP side

POST

/v0.5/health-information/hip/on-request

Acknowledge HIU health information request

POST

/v0.5/health-information/transfer

Transfer encrypted health records

POST

/v0.5/care-contexts/on-discover

Respond to patient care-context discovery

POST

/v0.5/links/link/init

Initiate care-context linking

POST

/v0.5/links/link/confirm

Confirm care-context linking

POST

/v0.5/links/link/add-contexts

Add new care contexts for a patient

POST

/v0.5/consents/hip/on-notify

Receive consent notification on HIP side

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Your HIP signing keys, id header, and gateway client secret are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'transfer encrypted health information from an HIP' or 'confirm a care-context link', and Jentic returns the matching HIP operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

Time to first call

FAQs

Specific to using Health Repository Provider Specifications for HIP API through Jentic.

Why is there no official OpenAPI spec for Health Repository Provider Specifications for HIP?

The National Health Authority publishes HIP responsibilities as written specifications and reference Postman collections rather than an OpenAPI document. Jentic generates and maintains this spec so that AI agents and developers can call Health Repository Provider Specifications for HIP via structured tooling. It is validated against the NDHM 0.5 specification and kept up to date. get started with Jentic One, the self-hosted execution layer.

What authentication does the NDHM HIP API use?

The OpenAPI spec does not declare a top-level security scheme because HIP endpoints validate Gateway-issued JWTs against the certificates published at /v0.5/certs and require the X-HIP-ID header. Through Jentic the HIP signing keys and id are stored encrypted in the vault and applied at execution time, so the agent context never sees the long-lived secret.

Can I transfer encrypted health records with the HIP API?

Yes. After validating an inbound consent artefact, POST /v0.5/health-information/transfer with the encrypted FHIR bundle, the key material reference, and the transaction id matching the HIU's original /v0.5/health-information/hip/request.

What are the rate limits for the HIP API?

The NDHM 0.5 specification does not publish per-endpoint rate limits in the OpenAPI document; throughput is governed by the participant onboarding agreement with the National Health Authority. Treat the dev.ndhm.gov.in/gateway sandbox as low-throughput and back off on 429 or 503 responses.

How do I link a care context through Jentic?

Run pip install jentic, then search for 'link a care context for a patient', load the schema for POST /v0.5/links/link/add-contexts, and execute it with the patient ABHA id and the new encounter references. Jentic returns the on-confirm acknowledgement payload.

Does the HIP API issue consent artefacts?

No. The HIP only consumes consent artefacts and serves records under their scope. Issuing artefacts is the responsibility of the Consent Manager, called via /v0.5/consent-requests/init on the Gateway.

Ndhm Health Repository Provider Specifications for HIP

Connect the Health Repository Provider Specifications for HIP to your agent

Capabilities

Start building with Health Repository Provider Specifications for HIP API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs