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.
| Parameter | Value |
|---|---|
| Service | Jan Aushadhi Kendra Discovery |
| HSPA operator | PMBI |
| Domain code | nic2008:47721 |
| Core version | 0.7.1 |
| Phase 1 scope | search and on_search only |
| Main fulfillment type | JANAUSHADHI |
| Medicine fulfillment type | JANAUSHADHI_MEDICINE |
| Stock fulfillment type | JANAUSHADHI_KENDRA |
Participant model
UHI uses 3 participants for this service. Read the shared protocol details at /docs/uhi/v1/network-and-protocol.
| Participant | Operator | Role |
|---|---|---|
| EUA | A health app | Send search and show Kendra records. |
| Gateway | NHA | Route each request and callback. |
| HSPA | PMBI | Return 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.
| Field | Value | Use |
|---|---|---|
context.domain | nic2008:47721 | Identify the service domain. |
message.intent.fulfillment.type | JANAUSHADHI | Search for Kendra records. |
message.intent.item.descriptor.code | JANAUSHADHI | Identify the Kendra item. |
message.intent.item.descriptor.name | JANAUSHADHI | Identify the Kendra item. |
provider_id | pmbi.hspa | Identify the PMBI HSPA. |
provider_uri | https://nha-pmbi.pmbi.co.in/api/store | Identify the PMBI HSPA endpoint. |
| HSPA public key ID | pmbi.hspapid.jak | Verify HSPA response signatures. |
| Sandbox Gateway URL | https://uhigatewaysandbox.abdm.gov.in/api/v1/uhi/search | Use the sandbox Gateway. |
| Production Gateway URL | https://uhigateway.abdm.gov.in/api/v1/uhi/search | Use 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.
{
"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"
}
}
}
}
}Medicine search
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.
{
"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.
{
"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
| Field | Type | Description |
|---|---|---|
domain | string | Use nic2008:47721. |
country | string | Use IND. |
city | string | Use an STD code, such as std:011. |
action | string | Use search. |
core_version | string | Use 0.7.1. |
consumer_id | string | Use the registered EUA ID. |
consumer_uri | string | Use the EUA HTTPS callback URL. |
message_id | UUID | Use a new value for each call. |
transaction_id | UUID | Use one value for one search session. |
timestamp | ISO 8601 | Use the request time. |
intent filter fields
| Field path | Type | Required | Description |
|---|---|---|---|
fulfillment.type | string | Yes | Use JANAUSHADHI, JANAUSHADHI_MEDICINE, or JANAUSHADHI_KENDRA. |
fulfillment.start.time.timestamp | datetime | Yes | Set the start time. |
fulfillment.end.time.timestamp | datetime | Yes | Set the end time. |
item.descriptor.code | string | Yes | Use the service code or medicine ID. |
item.descriptor.name | string | Yes | Use the service name or medicine name. |
category.descriptor.code | string | Conditional | Set a Kendra code search value. |
category.descriptor.name | string | Conditional | Set a Kendra code search value. |
location.state.name | string | No | Set the state name. |
location.state.code | string | No | Set the state code. |
location.district.name | string | No | Set the district name. |
location.district.code | string | No | Set the district code. |
location.gps | string | No | Set latitude and longitude. |
location.radius.type | string | No | Use CONSTANT for GPS. |
location.radius.value | string or float | No | Set the radius value. |
location.radius.unit | string | No | Use km. |
address.area_code | string | No | Set the 6-digit pincode. |
on_search provider record fields
| Field path | Type | Description |
|---|---|---|
catalog.providers[].id | string | Shows the PMBJP Kendra code. |
catalog.providers[].descriptor.name | string | Shows the Kendra name. |
catalog.providers[].descriptor.code | string | Shows the ownership type. |
catalog.providers[].descriptor.symbol | string | Shows the PMBI serial number. |
catalog.providers[].fulfillments[].type | string | Use contact for contact details. |
catalog.providers[].fulfillments[].agent.name | string | Shows the contact person. |
catalog.providers[].fulfillments[].start.time.timestamp | datetime | Shows the enrolment date. |
catalog.providers[].items[] | array | Shows medicine stock, when the flow returns stock. |
catalog.providers[].location.gps | string | Shows the Kendra GPS point. |
catalog.providers[].location.address | string | Shows the Kendra address. |
catalog.providers[].location.district | object | Shows the district name and code. |
catalog.providers[].location.state | object | Shows the state name and code. |
catalog.providers[].location.country | object | Shows INDIA and +91. |
catalog.providers[].contact.phone | string | Shows the Kendra phone number. |
catalog.providers[].contact.email | string | Shows the Kendra email. |
Contact and support
Use your NHA point of contact for onboarding, technical support, or interest forms.
| Item | Value |
|---|---|
| Organisation | National Health Authority, Ayushman Bharat Digital Mission |
| Service | Unified Health Interface - Jan Aushadhi Kendra Discovery |
| Primary contact | abdm.iosdev1@nha.gov.in |
| Other contacts | abdm.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
