AMRIT Pharmacy

Use UHI search and on_search to discover AMRIT Pharmacy records.

AMRIT Pharmacy discovery lets an EUA find AMRIT Pharmacy stores through UHI. HLL Lifecare Limited operates the HSPA for this service. Use this page for Phase 1 discovery-only flows.

Parameter	Value
Service	AMRIT Pharmacy Discovery
HSPA operator	HLL Lifecare Limited
Domain code	`nic2025:477201`
Core version	`0.7.1`
Phase 1 scope	`search` and `on_search` only
Fulfillment type	`AMRIT`
Item descriptor code	`AMRIT_PHARMACY`
Item descriptor name	`AMRIT_PHARMACY`

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 pharmacy records.
Gateway	NHA	Route each request and callback.
HSPA	HLL Lifecare Limited	Return AMRIT Pharmacy records.

Discovery flow

sequenceDiagram
  participant EUA
  participant Gateway
  participant HSPA as AMRIT 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 AMRIT Pharmacy payload.

Field	Value	Use
`context.domain`	`nic2025:477201`	Identify the service domain.
`message.intent.fulfillment.type`	`AMRIT`	Search for pharmacy records.
`message.intent.item.descriptor.code`	`AMRIT_PHARMACY`	Identify the pharmacy item.
`message.intent.item.descriptor.name`	`AMRIT_PHARMACY`	Identify the pharmacy item.
`provider_id`	`-`	Register this value with NHA.
`provider_uri`	`-`	Register this URL with NHA.
HSPA public key ID	`-`	Register this value with NHA.
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 an AMRIT Pharmacy code.

search — by pharmacy code

{
  "context": {
    "domain": "nic2025:477201",
    "country": "IND",
    "city": "std:011",
    "action": "search",
    "core_version": "0.7.1",
    "consumer_id": "eua-nha",
    "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": "Pharmacy Code",
          "name": "Pharmacy Code"
        }
      },
      "fulfillment": {
        "type": "AMRIT",
        "start": {
          "time": {
            "timestamp": "2026-06-09T00:00:00"
          }
        },
        "end": {
          "time": {
            "timestamp": "2026-06-09T23:59:59"
          }
        }
      },
      "item": {
        "descriptor": {
          "code": "AMRIT_PHARMACY",
          "name": "AMRIT_PHARMACY"
        }
      }
    }
  }
}

Representative on_search response

The AMRIT HSPA sends on_search to the EUA consumer_uri through the Gateway. This sample keeps 1 provider record and trims the longer array.

Source note

The source marks the AMRIT on_search payload as invalid JSON. The sample below keeps the same fields and fixes syntax.

on_search — AMRIT Pharmacy results, trimmed

{
  "context": {
    "domain": "nic2025:477201",
    "country": "IND",
    "city": "std:011",
    "action": "on_search",
    "core_version": "0.7.1",
    "consumer_id": "eua-nha",
    "consumer_uri": "https://uhieuasandbox.abdm.gov.in/api/v1/euaService",
    "provider_id": "amrit-hspa",
    "provider_uri": "https://amritpharmacy.gov.in/api/v1/admin/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": "AMRIT PHARMACY SERVICE",
        "images": "<AMRIT PHARMACY HSPA logo image URL>",
        "short_desc": "Short description of AMRIT PHARMACY HSPA",
        "long_desc": "Long description if available"
      },
      "providers": [
        {
          "id": "AMRITST01460",
          "descriptor": {
            "name": "ESIS NAGPUR",
            "code": "",
            "symbol": "",
            "short_desc": "AMRIT – ESIS NAGPUR",
            "long_desc": ""
          },
          "fulfillments": [
            {
              "id": "0",
              "type": "AMRIT",
              "agent": {
                "name": "<Contact Person Name>"
              },
              "start": {
                "time": {
                  "timestamp": "<storeOpeningTime>"
                }
              },
              "end": {
                "time": {
                  "timestamp": "<storeClosingTime>"
                }
              },
              "tags": {
                "@abdm/gov.in/hfr_id": "<hfrId>"
              }
            }
          ],
          "location": {
            "id": "1",
            "descriptor": {
              "name": "ESIS NAGPUR"
            },
            "city": {
              "name": "",
              "code": ""
            },
            "district": {
              "name": "NAGPUR",
              "code": "466"
            },
            "state": {
              "name": "Maharashtra",
              "code": "27"
            },
            "country": {
              "name": "INDIA",
              "code": "+91"
            },
            "gps": "19.7126974,74.4833288",
            "address": "AMRIT PHARMACY, ESIS HOSPITAL, SOMWARI ROAD, OPP. NURSES HOSTEL, KRIDA CHOWK, SOMWARIPETH, NAGPUR, MAHARASHTRA - 440009",
            "radius": {
              "type": "CONSTANT",
              "value": "12",
              "unit": "km"
            }
          },
          "contact": {
            "phone": "<pharmacyContactNumber>",
            "email": "<pharmacyContactEmail>"
          }
        }
      ]
    }
  }
}

Field reference

search context fields

Field	Type	Description
`domain`	string	Use `nic2025:477201`.
`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 `AMRIT`.
`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 `AMRIT_PHARMACY`.
`item.descriptor.name`	string	Yes	Use `AMRIT_PHARMACY`.
`category.descriptor.code`	string	Conditional	Set a pharmacy code search value.
`category.descriptor.name`	string	Conditional	Set a pharmacy 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 AMRIT store code.
`catalog.providers[].descriptor.name`	string	Shows the hospital name.
`catalog.providers[].descriptor.code`	string	The source leaves this value empty.
`catalog.providers[].descriptor.symbol`	string	The source leaves this value empty.
`catalog.providers[].descriptor.short_desc`	string	Shows the pharmacy label.
`catalog.providers[].fulfillments[].type`	string	Shows the pharmacy type.
`catalog.providers[].fulfillments[].agent.name`	string	Shows the contact person.
`catalog.providers[].fulfillments[].start.time.timestamp`	datetime	Shows the store open time.
`catalog.providers[].fulfillments[].end.time.timestamp`	datetime	Shows the store close time.
`catalog.providers[].fulfillments[].tags.@abdm/gov.in/hfr_id`	string	Shows the HFR ID.
`catalog.providers[].location.gps`	string	Shows the pharmacy GPS point.
`catalog.providers[].location.address`	string	Shows the pharmacy 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 pharmacy phone number.
`catalog.providers[].contact.email`	string	Shows the pharmacy 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 - AMRIT Pharmacy Discovery
Primary contact	abdm.iosdev1@nha.gov.in
Other contacts	abdm.pa1@nha.gov.in, abdm.cons11@nha.gov.in

Resources

Header Generation Toolkit
Header Generation Toolkit video
Swagger Specifications Link
UHI Developer Documentation

Sources

UHI_AMRIT_Pharmacy_OnboardingDoc_v1.0.docx, v1.0

PreviousJan Aushadhi Kendra