Static Hotel Supplier Search API

Overview

Returns a static third-party hotel supplier API response (formatted similar to TBO, TravelBullz, or Expedia aggregator responses) to simulate hotel inventory search.

• Endpoint: /api/supplier/hotels/search
• Method: POST

Request Payload Schema

Field	Type	Required	Description
checkIn	String	No	Check-in date (YYYY-MM-DD)
checkOut	String	No	Check-out date (YYYY-MM-DD)
rooms	Number	No	Number of rooms requested (Default: 1)
guests	Number	No	Number of guests (Default: 1)
city	String	No	Optional City name filter
currency	String	No	Target currency (Default: "INR")

Request Body Example

{
  "city": "Goa",
  "checkIn": "2026-10-01",
  "checkOut": "2026-10-05",
  "rooms": 1,
  "guests": 2,
  "currency": "INR"
}

Response Example (200 OK)

{
  "success": true,
  "data": {
    "status": "SUCCESS",
    "searchTraceId": "SUP-HTL-TRACE-88992211",
    "supplier": {
      "code": "TBO_HOTELS_MOCK",
      "name": "TravelBullz / TBO Hotel Aggregator",
      "currency": "INR",
      "responseTimeMs": 42
    },
    "searchParameters": {
      "city": "Goa",
      "checkIn": "2026-10-01",
      "checkOut": "2026-10-05",
      "nights": 4,
      "rooms": 1,
      "guests": 2
    },
    "hotels": [
      {
        "hotelCode": "HTL-GOA-001",
        "name": "Grand Palace Resort & Spa",
        "starRating": "FIVE_STAR",
        "address": "123 Beach Road, Calangute, North Goa",
        "cityName": "Goa",
        "country": "India",
        "latitude": 15.5432,
        "longitude": 73.7554,
        "heroImage": "https://images.unsplash.com/photo-1566073771259-6a8506099945",
        "amenities": ["Swimming Pool", "Spa & Wellness", "Free WiFi", "Beachfront"],
        "minRate": 18000,
        "maxRate": 32000,
        "currency": "INR",
        "rooms": [
          {
            "roomTypeCode": "DLX-OCN",
            "roomName": "Deluxe Ocean View Room",
            "maxOccupancy": 3,
            "mealPlan": "BREAKFAST_INCLUDED",
            "inventoryAvailable": 5,
            "pricing": {
              "basePricePerNight": 4500,
              "totalBasePrice": 18000,
              "totalTax": 2160,
              "totalNetPrice": 20160,
              "currency": "INR"
            },
            "rateKey": "RK_HTL_GOA001_DLX_20261001_4N",
            "cancellationPolicy": {
              "isRefundable": true,
              "freeCancellationBefore": "2026-09-29T23:59:59Z",
              "penaltyAmount": 0,
              "description": "Free cancellation until 48 hours before check-in."
            }
          }
        ]
      }
    ]
  },
  "message": "Static third-party hotel supplier response fetched successfully"
}