Health Repository Provider Specifications for HIU

ndhm · Data

Data No Auth Free & Open open_data

The following are the specifications for the APIs to be implemented at the Health Repository end if an entity is only serving the role of a HIU. The specs are essentially duplicates from the Gateway and Bridge, but put together so as to make it clear to *HIUs* which set of APIs they should implement to participate in the network. 1. The APIs are organized by the flows - **identification**, **consent flow**, **data flow** and **monitoring**. They represent the APIs that are expected to be ava

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET Get certs for JWT verification

Get certs for JWT verification

https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-hiu/0.5/v0.5/certs

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-hiu/0.5/v0.5/certs"

import requests
response = requests.get(
    "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-hiu/0.5/v0.5/certs",
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-hiu/0.5/v0.5/certs';

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-hiu/0.5/v0.5/certs"
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-hiu/0.5/v0.5/certs")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-hiu/0.5/v0.5/certs";
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Get consent request status

Get consent request status

https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-hiu/0.5/v0.5/heartbeat

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-hiu/0.5/v0.5/heartbeat"

import requests
response = requests.get(
    "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-hiu/0.5/v0.5/heartbeat",
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-hiu/0.5/v0.5/heartbeat';

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-hiu/0.5/v0.5/heartbeat"
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-hiu/0.5/v0.5/heartbeat")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-hiu/0.5/v0.5/heartbeat";
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Get openid configuration

Get openid configuration

https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-hiu/0.5/v0.5/.well-known/openid-configuration

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-hiu/0.5/v0.5/.well-known/openid-configuration"

import requests
response = requests.get(
    "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-hiu/0.5/v0.5/.well-known/openid-configuration",
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-hiu/0.5/v0.5/.well-known/openid-configuration';

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-hiu/0.5/v0.5/.well-known/openid-configuration"
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-hiu/0.5/v0.5/.well-known/openid-configuration")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-hiu/0.5/v0.5/.well-known/openid-configuration";
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with Health Repository Provider Specifications for HIU?

Health Repository Provider Specifications for HIU is a Data API. Developers commonly use data APIs for:

enriching your app with third-party datasets
building data pipelines and ETL workflows
querying and searching large datasets
powering research, analysis, and reporting tools
syncing reference data into your own systems

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Health Repository Provider Specifications for HIU is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗