ambulance

STEP 4 - on_init

Callback carrying the provider's reply to an ambulance booking init: the quote and the terms to confirm.

POST/ambulance-booking/on_init

Authorizations

Authorizationbearer tokenRequired

The access token from POST /api/hiecm/gateway/v3/sessions.

Body

contextobjectRequired

context.domainstringRequired

context.countrystringRequired

context.citystringRequired

context.actionstringRequired

context.timestampstringRequired

context.core_versionstringRequired

context.consumer_idstringRequired

context.consumer_uristringRequired

context.provider_idstringRequired

context.provider_uristringRequired

context.transaction_idstringRequired

context.message_idstringRequired

messageobjectRequired

message.orderobjectRequired

message.order.idstringRequired

message.order.statestringRequired

Responses

401

Example values, scrubbed.

Everything returns 401

404

Example values, scrubbed.

Error codes for this module

500

Example values, scrubbed.

Error codes for this module

STEP 4 - on_init

curl --request POST \
  --url https://phrsbx.abdm.gov.in/ambulance-booking/on_init \
  --header 'Authorization: Bearer <ACCESS_TOKEN_FROM_SESSIONS_CALL>' \
  --header 'Content-Type: application/json' \
  --data '{
  "context": {
    "domain": "nic2008:86909",
    "country": "IND",
    "city": "std:011",
    "action": "on_init",
    "timestamp": "2026-06-12T10:00:00",
    "core_version": "0.7.1",
    "consumer_id": "aarogyaSetu.eua",
    "consumer_uri": "https://aarogyasetu-sandbox.abdm.gov.in/aarogyasetu/api/v3/app/api/ambulance-booking",
    "provider_id": "nha.hspa",
    "provider_uri": "https://hspasbx.abdm.gov.in/api/v1/hspa/ambulance",
    "transaction_id": "<TXN_ID>",
    "message_id": "<TXN_ID>"
  },
  "message": {
    "order": {
      "id": "<O_R_D_E_R_I_D>",
      "state": "INITIALIZED"
    }
  }
}'

{
  "code": "900902",
  "message": "Missing Credentials",
  "description": "Invalid Credentials. Make sure your API invocation call has a header: 'Authorization : Bearer ACCESS_TOKEN' or 'Authorization : Basic ACCESS_TOKEN' or 'apikey: API_KEY'"
}

Generated from the schema. The values are placeholders, not a captured response.