Health ID Service

ndhm · Data

Data No Auth Free & Open open_data

It is important to standardize the process of identification of an individual across healthcare providers, to ensure that the created medical records are issued to the right individual or accessed by a Health Information User through appropriate consent. In order to issue a Health ID to an individual, one only needs basic demographic details like Name, Year of Birth, Gender. In addition, citizens should be able to update contact information easily.

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET Get a list of districts in a given State as per LGD.

Get a list of districts in a given State as per LGD.

https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-healthid/1.0/v1/ha/lgd/districts?stateCode=example

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-healthid/1.0/v1/ha/lgd/districts?stateCode=example"

import requests
params = {
    "stateCode": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-healthid/1.0/v1/ha/lgd/districts",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-healthid/1.0/v1/ha/lgd/districts');
url.searchParams.set('stateCode', 'example');

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

package main

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

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-healthid/1.0/v1/ha/lgd/districts")
	q := baseURL.Query()
	q.Set("stateCode", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	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-healthid/1.0/v1/ha/lgd/districts")
uri.query = URI.encode_www_form({
  "stateCode" => "example"
})

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-healthid/1.0/v1/ha/lgd/districts?" . http_build_query([
    "stateCode" => "example"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Get List of Benefits associated with HealthID.

Get List of Benefits associated with HealthID.

https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-healthid/1.0/v1/account/benefits

Hover any highlighted part to learn what it does

Headers — extra info sent with the request

X-Token

example

curl -X GET "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-healthid/1.0/v1/account/benefits" \
  -H "X-Token: example"

import requests
headers = {
    "X-Token": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-healthid/1.0/v1/account/benefits",
    headers=headers,
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-healthid/1.0/v1/account/benefits';

const response = await fetch(url, {
  headers: {
    'X-Token': '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-healthid/1.0/v1/account/benefits"
	req, _ := http.NewRequest("GET", targetURL, nil)
	req.Header.Set("X-Token", "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-healthid/1.0/v1/account/benefits")

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

req = Net::HTTP::Get.new(uri)
req["X-Token"] = "example"

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

<?php
$url = "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-healthid/1.0/v1/account/benefits";
$opts = ["http" => [
    "method" => "GET",
    "header" => implode("\r\n", [
        "X-Token: example"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Generate Health ID card in PDF format

Generate Health ID card in PDF format

https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-healthid/1.0/v1/account/getCard

Hover any highlighted part to learn what it does

Headers — extra info sent with the request

X-Token

example

curl -X GET "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-healthid/1.0/v1/account/getCard" \
  -H "X-Token: example"

import requests
headers = {
    "X-Token": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-healthid/1.0/v1/account/getCard",
    headers=headers,
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-healthid/1.0/v1/account/getCard';

const response = await fetch(url, {
  headers: {
    'X-Token': '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-healthid/1.0/v1/account/getCard"
	req, _ := http.NewRequest("GET", targetURL, nil)
	req.Header.Set("X-Token", "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-healthid/1.0/v1/account/getCard")

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

req = Net::HTTP::Get.new(uri)
req["X-Token"] = "example"

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

<?php
$url = "https://api.apis.guru/v2/specs/ndhm.gov.in/ndhm-healthid/1.0/v1/account/getCard";
$opts = ["http" => [
    "method" => "GET",
    "header" => implode("\r\n", [
        "X-Token: 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 ID Service?

Health ID Service 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 ID Service 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 ↗