National Health Authority

Command Palette

Search for a command to run...

Jan Aushadhi Kendra

Use UHI search and on_search to discover Jan Aushadhi Kendra records and medicine stock.

Jan Aushadhi Kendra discovery lets an EUA find Kendra records through UHI. PMBI operates the HSPA for this service. Use this page for Phase 1 discovery-only flows.

ParameterValue
ServiceJan Aushadhi Kendra Discovery
HSPA operatorPMBI
Domain codenic2008:47721
Core version0.7.1
Phase 1 scopesearch and on_search only
Main fulfillment typeJANAUSHADHI
Medicine fulfillment typeJANAUSHADHI_MEDICINE
Stock fulfillment typeJANAUSHADHI_KENDRA

Participant model

UHI uses 3 participants for this service. Read the shared protocol details at /docs/uhi/v1/network-and-protocol.

ParticipantOperatorRole
EUAA health appSend search and show Kendra records.
GatewayNHARoute each request and callback.
HSPAPMBIReturn Kendra and stock records.

Discovery flow

sequenceDiagram
  participant EUA
  participant Gateway
  participant HSPA as PMBI HSPA
  EUA->>Gateway: search
  Gateway-->>EUA: ACK
  Gateway->>HSPA: search
  HSPA-->>Gateway: ACK
  HSPA->>Gateway: on_search
  Gateway-->>HSPA: ACK
  Gateway->>EUA: on_search
  EUA-->>Gateway: ACK

Service identity

Use these values in each Jan Aushadhi Kendra payload.

FieldValueUse
context.domainnic2008:47721Identify the service domain.
message.intent.fulfillment.typeJANAUSHADHISearch for Kendra records.
message.intent.item.descriptor.codeJANAUSHADHIIdentify the Kendra item.
message.intent.item.descriptor.nameJANAUSHADHIIdentify the Kendra item.
provider_idpmbi.hspaIdentify the PMBI HSPA.
provider_urihttps://nha-pmbi.pmbi.co.in/api/storeIdentify the PMBI HSPA endpoint.
HSPA public key IDpmbi.hspapid.jakVerify HSPA response signatures.
Sandbox Gateway URLhttps://uhigatewaysandbox.abdm.gov.in/api/v1/uhi/searchUse the sandbox Gateway.
Production Gateway URLhttps://uhigateway.abdm.gov.in/api/v1/uhi/searchUse the production Gateway.

Authentication

Sign each search and on_search payload with an Ed25519 signature. Complete shared onboarding at /docs/uhi/v1/onboarding, then read signature details at /docs/uhi/v1/network-and-protocol.

Search variants

Use one search variant per user intent. Combine state, district, pincode, and GPS only when the user gives those filters.

Use this payload when the user knows a PMBJP Kendra code.

search — by Kendra code
{
  "context": {
    "domain": "nic2008:47721",
    "country": "IND",
    "city": "std:011",
    "action": "search",
    "core_version": "0.7.1",
    "consumer_id": "nha.eua",
    "consumer_uri": "https://uhieuasandbox.abdm.gov.in/api/v1/euaService",
    "message_id": "e9a19230-f951-11ec-b135-53aea776f66b",
    "timestamp": "2026-06-09T18:24:35",
    "transaction_id": "e9a19230-f951-11ec-b135-53aea776f66b"
  },
  "message": {
    "intent": {
      "category": {
        "descriptor": {
          "code": "PMBJK02129",
          "name": "PMBJK02129"
        }
      },
      "fulfillment": {
        "type": "JANAUSHADHI",
        "start": {
          "time": {
            "timestamp": "2026-06-19T00:00:00"
          }
        },
        "end": {
          "time": {
            "timestamp": "2026-06-19T23:59:59"
          }
        }
      },
      "item": {
        "descriptor": {
          "code": "JANAUSHADHI",
          "name": "JANAUSHADHI"
        }
      }
    }
  }
}

Use the medicine flow when the user wants a medicine or stock at a Kendra. Set JANAUSHADHI_MEDICINE for medicine discovery. Set JANAUSHADHI_KENDRA for Kendra stock discovery.

Use this payload to search medicine by name.

search — medicine by name
{
  "context": {
    "domain": "nic2008:47721",
    "country": "IND",
    "city": "std:011",
    "action": "search",
    "core_version": "0.7.1",
    "consumer_id": "eua-nha",
    "consumer_uri": "http://uhieuasandbox.abdm.gov.in/api/v1/euaService",
    "message_id": "e9a19230-f951-11ec-b135-53aea776f66b",
    "timestamp": "2026-06-09T18:24:35",
    "transaction_id": "e9a19230-f951-11ec-b135-53aea776f66b"
  },
  "message": {
    "intent": {
      "fulfillment": {
        "type": "JANAUSHADHI_MEDICINE",
        "start": {
          "time": {
            "timestamp": "2026-06-09T00:00:00"
          }
        },
        "end": {
          "time": {
            "timestamp": "2026-06-09T23:59:59"
          }
        }
      },
      "item": {
        "descriptor": {
          "code": "MedicineName (without space)",
          "name": "MedicineName"
        }
      }
    }
  }
}

Source note

The medicine source marks its medicine result payload and stock payload as invalid JSON. Preserve field intent, but validate syntax before use.

Representative on_search response

The PMBI HSPA sends on_search to the EUA consumer_uri through the Gateway. This sample keeps 2 provider records and trims the longer array.

on_search — Kendra results, trimmed
{
  "context": {
    "domain": "nic2008:47721",
    "country": "IND",
    "city": "std:011",
    "action": "on_search",
    "core_version": "0.7.1",
    "consumer_id": "nha.eua",
    "consumer_uri": "https://uhieuasandbox.abdm.gov.in/api/v1/euaService",
    "provider_id": "pmbi.hspa",
    "provider_uri": "https://staging-nha-pmbi.pmbi.co.in/api/store",
    "message_id": "e9a19230-f951-11ec-b135-53aea776f66b",
    "timestamp": "2026-06-09T18:24:35",
    "transaction_id": "e9a19230-f951-11ec-b135-53aea776f66b"
  },
  "message": {
    "catalog": {
      "descriptor": {
        "name": "JAN AUSHADHI KENDRA HSPA",
        "images": "https://janaushadhi.gov.in/img/bhartiya_janaushadhi_priyojna_2.svg",
        "short_desc": "",
        "long_desc": ""
      },
      "providers": [
        {
          "id": "PMBJK10844",
          "descriptor": {
            "name": "Jan Aushadhi Kendra",
            "code": "PP",
            "symbol": "1",
            "short_desc": "",
            "long_desc": ""
          },
          "fulfillments": [
            {
              "id": "0",
              "type": "contact",
              "agent": {
                "name": "Sunita Zanwar"
              },
              "start": {
                "time": {
                  "timestamp": "2023-06-30T00:00:00"
                }
              }
            }
          ],
          "location": {
            "id": "1",
            "descriptor": {
              "name": "Jan Aushadhi Kendra"
            },
            "city": {
              "name": "",
              "code": ""
            },
            "district": {
              "name": "PUNE",
              "code": "490"
            },
            "state": {
              "name": "Maharashtra",
              "code": "27"
            },
            "country": {
              "name": "INDIA",
              "code": "+91"
            },
            "gps": "18.51996721338908,73.86697649999999",
            "address": "Shop No.2,CTS No.350,Sai Appartment,Near KEM Hospital Rasta Peth, Pune, Pune, Maharashtra, India - 411011",
            "radius": {
              "type": "CONSTANT",
              "value": "1.19",
              "unit": "km"
            }
          },
          "contact": {
            "phone": "9309534959",
            "email": "janaushadhikem@gmail.com"
          }
        },
        {
          "id": "PMBJK08762",
          "descriptor": {
            "name": "Jan Aushadhi Kendra",
            "code": "PP",
            "symbol": "2",
            "short_desc": "",
            "long_desc": ""
          },
          "fulfillments": [
            {
              "id": "0",
              "type": "contact",
              "agent": {
                "name": "PAYAL SAMDARIYA"
              },
              "start": {
                "time": {
                  "timestamp": "2021-07-29T00:00:00"
                }
              }
            }
          ],
          "location": {
            "id": "1",
            "descriptor": {
              "name": "Jan Aushadhi Kendra"
            },
            "city": {
              "name": "",
              "code": ""
            },
            "district": {
              "name": "PUNE",
              "code": "490"
            },
            "state": {
              "name": "Maharashtra",
              "code": "27"
            },
            "country": {
              "name": "INDIA",
              "code": "+91"
            },
            "gps": "18.51787100000001,73.86446748220898",
            "address": "Seth Tarachand Ayurvedic Hospital, Rasta Peth, Pune, Pune, Maharashtra, India - 411011",
            "radius": {
              "type": "CONSTANT",
              "value": "1.54",
              "unit": "km"
            }
          },
          "contact": {
            "phone": "8055150706",
            "email": "payalpmbjk@gmail.com"
          }
        }
      ]
    }
  }
}

Field reference

search context fields

FieldTypeDescription
domainstringUse nic2008:47721.
countrystringUse IND.
citystringUse an STD code, such as std:011.
actionstringUse search.
core_versionstringUse 0.7.1.
consumer_idstringUse the registered EUA ID.
consumer_uristringUse the EUA HTTPS callback URL.
message_idUUIDUse a new value for each call.
transaction_idUUIDUse one value for one search session.
timestampISO 8601Use the request time.

intent filter fields

Field pathTypeRequiredDescription
fulfillment.typestringYesUse JANAUSHADHI, JANAUSHADHI_MEDICINE, or JANAUSHADHI_KENDRA.
fulfillment.start.time.timestampdatetimeYesSet the start time.
fulfillment.end.time.timestampdatetimeYesSet the end time.
item.descriptor.codestringYesUse the service code or medicine ID.
item.descriptor.namestringYesUse the service name or medicine name.
category.descriptor.codestringConditionalSet a Kendra code search value.
category.descriptor.namestringConditionalSet a Kendra code search value.
location.state.namestringNoSet the state name.
location.state.codestringNoSet the state code.
location.district.namestringNoSet the district name.
location.district.codestringNoSet the district code.
location.gpsstringNoSet latitude and longitude.
location.radius.typestringNoUse CONSTANT for GPS.
location.radius.valuestring or floatNoSet the radius value.
location.radius.unitstringNoUse km.
address.area_codestringNoSet the 6-digit pincode.

on_search provider record fields

Field pathTypeDescription
catalog.providers[].idstringShows the PMBJP Kendra code.
catalog.providers[].descriptor.namestringShows the Kendra name.
catalog.providers[].descriptor.codestringShows the ownership type.
catalog.providers[].descriptor.symbolstringShows the PMBI serial number.
catalog.providers[].fulfillments[].typestringUse contact for contact details.
catalog.providers[].fulfillments[].agent.namestringShows the contact person.
catalog.providers[].fulfillments[].start.time.timestampdatetimeShows the enrolment date.
catalog.providers[].items[]arrayShows medicine stock, when the flow returns stock.
catalog.providers[].location.gpsstringShows the Kendra GPS point.
catalog.providers[].location.addressstringShows the Kendra address.
catalog.providers[].location.districtobjectShows the district name and code.
catalog.providers[].location.stateobjectShows the state name and code.
catalog.providers[].location.countryobjectShows INDIA and +91.
catalog.providers[].contact.phonestringShows the Kendra phone number.
catalog.providers[].contact.emailstringShows the Kendra email.

Contact and support

Use your NHA point of contact for onboarding, technical support, or interest forms.

ItemValue
OrganisationNational Health Authority, Ayushman Bharat Digital Mission
ServiceUnified Health Interface - Jan Aushadhi Kendra Discovery
Primary contactabdm.iosdev1@nha.gov.in
Other contactsabdm.pa1@nha.gov.in, abdm.cons11@nha.gov.in

Resources

Sources

  • UHI_JanAushadhiKendra_OnboardingDoc_v1.0.docx, v1.0
  • UHI_JanAushadhiKendra_search_v0.3.docx, v0.3
  • JanAushadhiKendra_medicineSearch_v0.3.docx, v0.3