ambulance

STEP 1 - search

Searches for ambulance services. Beckn search action; results arrive at on_search.

POST/ambulance-booking/search

Authorizations

Authorizationbearer tokenRequired

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

Body

contextobjectRequired

context.domainstringRequired

context.countrystringRequired

context.citystringRequired

context.actionstringRequired

context.core_versionstringRequired

context.consumer_idstringRequired

context.consumer_uristringRequired

context.message_idstringRequired

context.timestampstringRequired

context.transaction_idstringRequired

messageobjectRequired

message.intentobjectRequired

message.intent.categoryobjectRequired

message.intent.category.descriptorobjectRequired

message.intent.fulfillmentobjectRequired

message.intent.fulfillment.typestringRequired

message.intent.fulfillment.startobjectRequired

message.intent.fulfillment.endobjectRequired

message.intent.locationsobject[]Required

message.intent.locations.descriptorobjectRequired

message.intent.locations.gpsstringRequired

message.intent.locations.addressstringRequired

message.intent.itemobjectRequired

message.intent.item.descriptorobjectRequired

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 1 - search

curl --request POST \
  --url https://phrsbx.abdm.gov.in/ambulance-booking/search \
  --header 'Authorization: Bearer <ACCESS_TOKEN_FROM_SESSIONS_CALL>' \
  --header 'Content-Type: application/json' \
  --data '{
  "context": {
    "domain": "nic2008:86909",
    "country": "IND",
    "city": "std:011",
    "action": "search",
    "core_version": "0.7.1",
    "consumer_id": "aarogyaSetu.eua",
    "consumer_uri": "https://aarogyasetu-sandbox.abdm.gov.in/aarogyasetu/api/v3/app/api/ambulance-booking",
    "message_id": "<TXN_ID>",
    "timestamp": "2026-06-12T10:00:00",
    "transaction_id": "<TXN_ID>"
  },
  "message": {
    "intent": {
      "category": {
        "descriptor": {
          "code": "ALL",
          "name": "<NAME>"
        }
      },
      "fulfillment": {
        "type": "EMERGENCY",
        "start": {
          "time": {
            "timestamp": "2026-06-12T10:00:00"
          }
        },
        "end": {
          "time": {
            "timestamp": "2026-06-12T23:59:59"
          }
        }
      },
      "locations": [
        {
          "descriptor": {
            "code": "SOURCE",
            "name": "<NAME>"
          },
          "gps": "12.423423,77.325647",
          "address": "<ADDRESS>"
        }
      ],
      "item": {
        "descriptor": {
          "code": "AMBULANCE",
          "name": "<NAME>"
        }
      }
    }
  }
}'

{
  "code": "900901",
  "message": "Invalid Credentials",
  "description": "Invalid Credentials. Make sure you have provided the correct security credentials"
}

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