ambulance

STEP 3 - init

Initialises an ambulance booking for the service selected from search results. Beckn init action; the reply arrives at on_init.

POST/ambulance-booking/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

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 3 - init

curl --request POST \
  --url https://phrsbx.abdm.gov.in/ambulance-booking/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": "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>"
    }
  }
}'

{
  "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.