Health Data Consent Manager

ndhm · Data

Data No Auth Free & Open open_data

Entity which provides health information aggregation services to customers of health care services. It enables customers to fetch their health information from one or more Health Information Providers (e.g., Hospitals, Diagnostic Labs, Medical Device Companies), based on their explicit Consent and to share such aggregated information with Health Information Users i.e. entities in need of such data (e.g., Insurers, Doctors, Medical Researchers). # Specifications 1. This document maintains only t

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET Get consent request status

Get consent request status

https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-cm/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-cm/0.5/v0.5/heartbeat"

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

const url = 'https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-cm/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-cm/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-cm/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-cm/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));

POST Response to patient's account discovery request

Result of patient care-context discovery request at HIP end. If a matching patient found with zero or more care contexts associated, it is specified as result attribute. If the prior discovery request, resulted in errors then it is specified in the error attribute. Reasons of errors can be 1. **m

https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-cm/0.5/v0.5/care-contexts/on-discover

Hover any highlighted part to learn what it does

Headers — extra info sent with the request

Authorization

example

curl -X POST "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-cm/0.5/v0.5/care-contexts/on-discover" \
  -H "Authorization: example"

import requests
headers = {
    "Authorization": "example"
}
response = requests.post(
    "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-cm/0.5/v0.5/care-contexts/on-discover",
    headers=headers,
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-cm/0.5/v0.5/care-contexts/on-discover';

const response = await fetch(url, {
  method: 'POST',
  headers: {
    'Authorization': 'example'
  },
}); 
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-cm/0.5/v0.5/care-contexts/on-discover"
	req, _ := http.NewRequest("POST", targetURL, nil)
	req.Header.Set("Authorization", "example")

	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-cm/0.5/v0.5/care-contexts/on-discover")

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

req = Net::HTTP::Post.new(uri)
req["Authorization"] = "example"

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

<?php
$url = "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-cm/0.5/v0.5/care-contexts/on-discover";
$opts = ["http" => [
    "method" => "POST",
    "header" => implode("\r\n", [
        "Authorization: example"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

POST Create consent request

Creates a consent request to get data about a patient by HIU user. CM should call Gateway - ***/v0.5/consent-requests/on-init*** API with the consent-request-id

https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-cm/0.5/v0.5/consent-requests/init

Hover any highlighted part to learn what it does

Headers — extra info sent with the request

Authorization

example

curl -X POST "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-cm/0.5/v0.5/consent-requests/init" \
  -H "Authorization: example"

import requests
headers = {
    "Authorization": "example"
}
response = requests.post(
    "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-cm/0.5/v0.5/consent-requests/init",
    headers=headers,
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-cm/0.5/v0.5/consent-requests/init';

const response = await fetch(url, {
  method: 'POST',
  headers: {
    'Authorization': 'example'
  },
}); 
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-cm/0.5/v0.5/consent-requests/init"
	req, _ := http.NewRequest("POST", targetURL, nil)
	req.Header.Set("Authorization", "example")

	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-cm/0.5/v0.5/consent-requests/init")

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

req = Net::HTTP::Post.new(uri)
req["Authorization"] = "example"

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

<?php
$url = "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-cm/0.5/v0.5/consent-requests/init";
$opts = ["http" => [
    "method" => "POST",
    "header" => implode("\r\n", [
        "Authorization: example"
    ]),
]];
$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 Data Consent Manager?

Health Data Consent Manager 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 Data Consent Manager 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 ↗