Pre-authorisation
Pre-authorisation is the provider's formal request for the payer's approval to deliver a specific treatment to a covered beneficiary.
Calls
| Call | Method and path | What it does |
|---|---|---|
| Pre-authorisation submit | POST /v1/preauth/submit | Provider submits, resubmits, enhances or answers a query on a pre-authorisation Claim bundle (Claim.use preauthorization); NHCX routes it to the payer. Also sent as pre-authorisation enhancement. |
| Pre-authorisation submit (internal) (adapter) | POST /internal/v1/preauth/submit | Internal twin of /v1/preauth/submit (operationId preauthSubmitPostInternal) with the same JWEPayload body and response set. |
| Pre-authorisation callback | POST /v1/preauth/on_submit | Payer returns the ClaimResponseBundle for a pre-authorisation (approved, partially approved, queried or rejected) to the provider via NHCX. |
| Pre-authorisation callback (internal) (adapter) | POST /internal/v1/preauth/on_submit | Internal twin of /v1/preauth/on_submit (operationId preauthOnSubmitPostInternal) with the same JWEPayload body and response set. |
Callbacks you host
The exchange posts these to the endpoint_url you registered. Answer each with HTTP 202 first.
| Path | Hosted by |
|---|---|
/v1/preauth/submit | The payer |
/v1/preauth/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
- Building and sending a JWE
- Preauthorisation request
- Preauthorisation response
- Preauthorisation enhancement
- Preauthorisation query and answer
The whole specification, with a request you can send from the page, is the Pre-authorisation API reference.