Room Search

POST

/api/v1/generic-api-service/royal/room/search

The room search endpoint is used to display information about the hotel's available rooms that are listed in the hotels list.

Request

{
  "hotelCode": "djuk19kyv9zd",
  "checkIn": "2023-04-18",
  "checkOut": "2023-04-21",
  "clientNationality": "TR",
  "feedId": "29d940b4-368a-4ebe-b560-9ad4f512d890",
  "rooms": [
    {
      "adults": 2,
      "child": 1,
      "childAges": [2]
    }
  ]
}

Response

{
  "hotelCode": "djuk19kyv9zd",
  "hotelName": "Quality Inn",
  "roomSearchId": "1ca0b3e8-ff7e-455e-97a1-c2f201f1c0c5",
  "destinations": [
    {
      "id": 631,
      "type": "COUNTRY",
      "typeId": 0,
      "name": "United States"
    },
    {
      "id": 104369,
      "type": "CITY",
      "typeId": 0,
      "name": "Forsyth"
    },
    {
      "id": 98951,
      "type": "TOWN",
      "typeId": 0,
      "name": "Macon"
    },
    {
      "id": 104369,
      "type": "CITY",
      "typeId": 0,
      "name": "Forsyth"
    }
  ],
  "rooms": [
    {
      "pax": {
        "adult": 2,
        "child": 1,
        "childAges": [2]
      },
      "roomType": "Standard Room, 2 Double Beds, Non Smoking",
      "roomCode": "201467946",
      "rates": [
        {
          "totalPrice": 226.44,
          "nightlyPrices": [
            {
              "date": "2023-04-20",
              "amount": 12.71,
              "currency": "EUR"
            }
          ],
          "priceCode": "56661|sxp0727y0bu6|34|2023-04-18|2023-04-21|2|Sales|299al71lcqw4kzk73ey21tn0bculxx036|1sjfx11m7q5hczdq7bi2biudz4hpyvok6",
          "cancellationPolicies": [
            {
              "amount": 0.0,
              "currency": "EUR",
              "toDate": "2023-09-05T12:00:00",
              "fromDate": "2023-07-13T12:10:47.956938"
            },
            {
              "amount": 500.0,
              "currency": "EUR",
              "toDate": "2023-09-10T12:00:00",
              "fromDate": "2023-09-05T12:00:00"
            },
            {
              "amount": 1000.0,
              "currency": "EUR",
              "toDate": "2023-09-15T12:00:00",
              "fromDate": "2023-09-10T12:00:00"
            }
          ],
          "mealType": "Bed and Breakfast",
          "mealTypeCode": "BB",
          "taxes": [
            {
              "type": "tax_and_service_fee",
              "price": 38.13,
              "currency": "EUR",
              "description": "tax and service fee",
              "included": true
            }
          ],
          "fees": [
            {
              "type": "hotel_fee",
              "price": 10.2,
              "currency": "EUR",
              "description": "hotel fee",
              "included": true
            }
          ],
          "refundable": true
        }
      ]
    }
  ]
}

Request Details

Name	Type	Required	Description
hotelCode	string	Yes	'Code of the hotel that is clicked and directed to the details after the search is made.
checkIn	string	Yes	'checkIn' parameter refers to the day of check-in to the hotel. It should be sent in the format 'YYYY-MM-DD'.
checkOut	string	Yes	'checkout' parameter refers to the day of departure from the hotel. It should be sent in YYYY-MM-DD format. The date to be sent in the checkout parameter must be after the date to be sent in the checkin parameter.
clientNationality	string	Yes	The country of the guests who will be included in the reservation. It must be sent as a 2-digit country code. If the reservation includes guests from more than one country, the country of the first guest of the reservation must be sent.
feedId	UUID	Yes	'feedId' parameter refers to pricetype(B2B,B2C). The unique feed ID provided must be submitted.
rooms	object-array	Yes	It is the information of the room to be reserved. Currently, only 1 room can be reserved per 1 reservation. When the multi-room feature is provided, it will be seen in the document.
rooms/adults	int	Yes	The number of adults that can be accommodated. It can take a value between 1 and X.
rooms/child	int	No	The number of children that can be accommodated. It can take a value between 1 and X.
rooms/childAges	int-array	No	If there are children in the reservation, age of the children must be sent. It can take values between 0 and X.

Response Details

Name	Type	Required	Description
hotelCode	string	Yes	Code of the selected hotel.
hotelName	string	Yes	Name of the selected hotel.
roomSearchId	string	Yes	During the room search, this key will keep the response data in the cache. It will be in the Book request and produced by us.
destinations	object-array	Yes	The destinations where the hotel is located are placed in the 'destinationCode' object.
destinations/id	int	Yes	Destination id in Etstur structure.
destinations/type	string	Yes	Destination type in Etstur structure.
destinations/typeId	int	Yes	Destination typeId in Etstur structure.
destinations/name	string	Yes	Destination name in Etstur structure.
rooms	object-array	Yes	The 'rooms' object returns information about all of the hotel's rooms.
rooms/pax	object	Yes	Information about the guests that can be accommodated.
rooms/pax/adult	object	Yes	The number of adults that can be accommodated.
rooms/pax/child	int	No	The number of cildren that can be accommodated.
rooms/pax/childAges	int	No	If there are children in the reservation, age of the children must be sent.
rooms/roomType	string	Yes	Room type in Etstur structure.
rooms/roomCode	string	Yes	Room code in Etstur structure.
rooms/rates	object-array	Yes	Structure that enables the display of room plans at various rates.
rooms/rates/totalPrice	decimal	Yes	Total price of the room.
rooms/rates/nightlyPrices	object-array	Yes	An object that allows the room's nightly prices to be displayed separately and Price must be big decimal type.
rooms/rates/nightlyPrices/date	string	Yes	Date of the day, date format must be YYYY-MM-DD
rooms/rates/nightlyPrices/amount	decimal	Yes	Price amount of the day
rooms/rates/nightlyPrices/currency	string	Yes	Information in which currency the reservation amount is in is returned with the 'currency' parameter.
rooms/rates/priceCode	string	Yes	Unique value generated for that price in each room search by us. The validity period of the price code is 30 minutes.
rooms/rates/cancellationPolicies	object-array	No	Object to return information for cancellation policies.
rooms/rates/cancellationPolicies/amount	decimal	No	Penalty amount to be paid
rooms/rates/cancellationPolicies/currency	string	No	Penalty amount currency to be paid
rooms/rates/cancellationPolicies/toDate	string	No	Cancellation policy is valid for UTC+03:00 time zone.
rooms/rates/cancellationPolicies/fromDate	string	No	Cancellation policy is valid for UTC+03:00 time zone.
rooms/rates/mealType	string	Yes	Meal type in Etstur structure.
rooms/rates/mealTypeCode	string	Yes	Meal type code in Etstur structure.
rooms/rates/taxes	object-array	No	If there is a tax related to accommodation, it will be included in this field.
rooms/rates/taxes/type	string	No	Tax type
rooms/rates/taxes/price	decimal	No	Tax amount
rooms/rates/taxes/currency	string	No	Tax currency
rooms/rates/taxes/description	string	No	Tax description
rooms/rates/taxes/included	boolean	No	Information whether the tax price is included in the total amount. Included if it is True and not included if it is False.
rooms/rates/fees	object-array	No	If there is an extra fee related to accommodation, it will be included in this field.
rooms/rates/fees/type	string	No	Fee type
rooms/rates/fees/price	decimal	No	Fee amount
rooms/rates/fees/currency	string	No	Fee currency
rooms/rates/fees/description	string	No	Fee description
rooms/rates/fees/included	boolean	No	Information whether the extra fee is included in the total amount. Included if it is True and not included if it is False.
rooms/rates/refundable	boolean	Yes	Information about whether the reservation is cancelled. Refundable if it is True, nonrefundable if it is False.