Status and search
Asynchronous exchanges lose messages, stall in queues and outlive the shift of the desk operator who started them.
Calls
| Call | Method and path | What it does |
|---|---|---|
| Status check | POST /v1/status | Sender asks NHCX where its own in-flight request stands; the gateway answers request.queued or request.dispatched, and only dispatched yields a callback. |
| Search submit | POST /v1/search/submit | Authorised entity such as NHA or IRDAI sends a Task to retrieve claim information for a case; the payer returns the documents on the search callback. |
| Search result callback | POST /v1/search/on_submit | Callback returning a search result for task type code=poll; for a claim-document search the payload is the ClaimResponse for the reference number. |
Callbacks you host
The exchange posts these to the endpoint_url you registered. Answer each with HTTP 202 first.
| Path | Hosted by |
|---|---|
/v1/status | The payer |
/v1/search/submit | The payer |
/v1/search/on_submit | The provider |
Base URLs
| Environment | Base URL |
|---|---|
| Sandbox, NHCX exchange. | https://apisbx.abdm.gov.in/hcx |
| Production. | https://apisprod.nha.gov.in/hcx |
Guides that use these calls
- Predetermination, status and search
- Accepted with 202, and no callback arrives
- Responses arrive against the wrong request
The whole specification, with a request you can send from the page, is the Status and search API reference.