Booking Detail & Pricing API

Overview

Retrieves full room/flight options, fare breakdowns, baggage policies, amenities, and exact pricing details for a selected Hotel or Flight.

• Endpoint: /api/search/details (or /api/search/hotel-details, /api/search/flight-details)
• Method: GET
• Headers:
  • Authorization: Bearer <token> (Optional/Standard JWT)

Query Parameters

Parameter	Type	Required	Description
type	Enum	Yes	Detail target vertical: HOTEL or FLIGHT
id / hotelId / hid	String	Conditional	Hotel property ID (for type=HOTEL) or Flight Price ID (for type=FLIGHT)
priceId	String	Conditional	Specific Flight Price ID from search response
checkIn / checkInDate	String	No	Check-in date in YYYY-MM-DD format
checkOut / checkOutDate	String	No	Check-out date in YYYY-MM-DD format
adults / guests	Number	No	Adult guest count per room (Default: 2)
children	Number	No	Child guest count per room (Default: 0)
childAges / childAge	String / Array	No	Child ages in years
rooms	Array / JSON	No	Optional array of room objects [{ adults, children, childAge }]
currency	String	No	3-letter currency code (Default: INR)
nationality	String	No	Guest nationality code (Default: 106)
correlationId	String	No	Tracking ID (auto-generated if omitted)
timeoutMs	Number	No	Request timeout in milliseconds (Default: 13000)

Note: At least one identifier (id, hotelId, hid, or priceId) must be provided.

Response Example - Hotel Details (200 OK)

{
  "success": true,
  "data": {
    "type": "HOTEL",
    "query": {
      "type": "HOTEL",
      "hotelId": "HT-4001"
    },
    "details": {
      "hotelDetail": {
        "hotelId": "HT-4001",
        "name": "Taj Lands End",
        "starRating": 5,
        "address": "Bandra West, Mumbai",
        "rooms": [
          {
            "roomId": "RM-DELUXE-01",
            "name": "Deluxe Sea View Room",
            "pricing": {
              "baseFare": 12500,
              "taxes": 2250,
              "totalPrice": 14750
            }
          }
        ]
      }
    }
  },
  "message": "Hotel detail view & pricing fetched successfully"
}

Response Example - Flight Review & Pricing (200 OK)

{
  "success": true,
  "data": {
    "type": "FLIGHT",
    "query": {
      "type": "FLIGHT",
      "priceId": "PRICE-FL-9021"
    },
    "details": {
      "tripInfos": [
        {
          "priceInfo": {
            "baseFare": 4200,
            "taxes": 650,
            "totalPrice": 4850
          },
          "baggageAllowance": {
            "checkIn": "15 KG",
            "cabin": "7 KG"
          }
        }
      ]
    }
  },
  "message": "Flight detail view & pricing fetched successfully"
}