5. Get Price Details
Version 5.1 by Giorgi Mdivnishvili on 2024/02/29 12:17
Contents
Method Description
With the parameters provided in GetHotels and GetCities reponse, it’s avaible to search hotels with the desired parameters in Hotels Search.
endpoint : https://testapi.rustaronline.com//api/Hotels/GetPriceDetails
Method POST
Request example:
{
"contragentContactUID": "55a2fcfb-8378-4b73-ab1e-bc8e5c836f4e",
"countryMask": "TR",
"checkInDate": "2024-05-06T00:00:00",
"checkOutDate": "2024-05-07T00:00:00",
"Adults": 1,
"Children": 0,
"ChildrenAges": "",
"priceCode": "CVNP",
"roomCategoryCode": "TWTW",
"hotels": [
{
"hotelCode": "da9b081d-b963-4fb7-ad19-8c375ce60da1"
}
]
}
"contragentContactUID": "55a2fcfb-8378-4b73-ab1e-bc8e5c836f4e",
"countryMask": "TR",
"checkInDate": "2024-05-06T00:00:00",
"checkOutDate": "2024-05-07T00:00:00",
"Adults": 1,
"Children": 0,
"ChildrenAges": "",
"priceCode": "CVNP",
"roomCategoryCode": "TWTW",
"hotels": [
{
"hotelCode": "da9b081d-b963-4fb7-ad19-8c375ce60da1"
}
]
}
Definition of Request Parameters
| Parameter | Value | Description |
| "MaxResultCount" | 2, | Maximum number of results to display |
| "MaxHotelCount" | 2, | Maximum number of hotels to display results |
| "contragentContactUID" | "55a2fcfb-8378-4b73-ab1e-bc8e5c836f4e", | A unique code assigned to each application user |
| "countryMask" | "TR", | Country code, which can be retrieved in Get Cities method, in parameter [countrycode] |
| "CheckInDate" | "2024-05-06", | Check in date "YY-MM-DD" |
| "CheckOutDate" | "2024-05-07", | Check out date "YY-MM-DD" |
| "Adults" | 1, | number of Adults |
| "Children" | 0, | Number of children |
| "ChildrenAges" | "", | children ages, the must be separated with "," |
| "cityUID" | "e1344ba0-5273-4fc1-b6c4-72446260f430" | Code of the city, which is available in method Get Cities in parameter [cityid] |
In case there is need to display hotels in whole country, no mater cities, it's possible to remove "arrivalCities" parameter.
Response Example
{
"result": [
{
"resultID": 1656448260000000001,
"hotelID": 177798,
"providerID": 8,
"roomCategoryCode": "TWTW",
"roomCategoryName": "Deluxe Guest room, 2 Twins",
"mealPlanName": "RO",
"placementType": 1,
"placementTypeName": "SNGL",
"priceCode": "CVNP",
"note": "Deluxe, 2 Twins, Mini fridge, 23sqm/247sqft-25sqm/269sqft, Wireless internet, complimentary, Wired internet, complimentary, Coffee/tea maker, 43in/109cm LED TV Cancellation Policy: penalty for cancellation 0-24 hours before checkin is EUR 108.37, penalty for cancellation after 12AM is EUR 108.37, penalty for NoShow is EUR 108.37",
"priceCurrency": "EUR",
"priceCurrencySrc": "EUR",
"availability": 3,
"availableRoomsCount": 0,
"totalSellPriceSrc": 109.44,
"totalSellPrice": 109.44,
"totalPriceSurcharge": 0.00,
"cancellationPolicyDescription": "Cancellation Policy: 1 Day Before Arrival: 108.37 Value, Early Departure: 100.00 %, NoShow: 108.37 Value",
"cancellationPolicy": {
"noShowChargeValue": 108.37,
"noShowChargeValueType": "Value",
"earlyDepartureChargeValue": 100,
"earlyDepartureChargeValueType": "%",
"conditions": [
{
"timeunits": 1,
"timeunitType": "Day",
"timeOffsetTypeName": "Before Arrival",
"chargeValue": 108.37,
"chargeValueType": "Value"
}
]
},
"searchId": 1709194519,
"hotelCode": "da9b081d-b963-4fb7-ad19-8c375ce60da1",
"id": 1656448260000000001,
"hotel": {
"hotelCode": "da9b081d-b963-4fb7-ad19-8c375ce60da1",
"hotelName": "Delta Hotels Istanbul Halic",
"hotelClass": "****",
"cityId": "e1344ba0-5273-4fc1-b6c4-72446260f430",
"cityName": "Istanbul",
"countryCode": "TR",
"districtId": "24528bb1-a6d9-4514-8d92-754056a9f48e",
"districtName": "Kagytkhane",
"note": ""
},
"adults": 1,
"children": 0,
"childrenAges": "",
"childrenExeptInfants": 0,
"checkInDate": "2024-05-06T00:00:00",
"checkOutDate": "2024-05-07T00:00:00",
"includedExtrasAmount": 0,
"extraServices": []
}
],
"error": false
}
"result": [
{
"resultID": 1656448260000000001,
"hotelID": 177798,
"providerID": 8,
"roomCategoryCode": "TWTW",
"roomCategoryName": "Deluxe Guest room, 2 Twins",
"mealPlanName": "RO",
"placementType": 1,
"placementTypeName": "SNGL",
"priceCode": "CVNP",
"note": "Deluxe, 2 Twins, Mini fridge, 23sqm/247sqft-25sqm/269sqft, Wireless internet, complimentary, Wired internet, complimentary, Coffee/tea maker, 43in/109cm LED TV Cancellation Policy: penalty for cancellation 0-24 hours before checkin is EUR 108.37, penalty for cancellation after 12AM is EUR 108.37, penalty for NoShow is EUR 108.37",
"priceCurrency": "EUR",
"priceCurrencySrc": "EUR",
"availability": 3,
"availableRoomsCount": 0,
"totalSellPriceSrc": 109.44,
"totalSellPrice": 109.44,
"totalPriceSurcharge": 0.00,
"cancellationPolicyDescription": "Cancellation Policy: 1 Day Before Arrival: 108.37 Value, Early Departure: 100.00 %, NoShow: 108.37 Value",
"cancellationPolicy": {
"noShowChargeValue": 108.37,
"noShowChargeValueType": "Value",
"earlyDepartureChargeValue": 100,
"earlyDepartureChargeValueType": "%",
"conditions": [
{
"timeunits": 1,
"timeunitType": "Day",
"timeOffsetTypeName": "Before Arrival",
"chargeValue": 108.37,
"chargeValueType": "Value"
}
]
},
"searchId": 1709194519,
"hotelCode": "da9b081d-b963-4fb7-ad19-8c375ce60da1",
"id": 1656448260000000001,
"hotel": {
"hotelCode": "da9b081d-b963-4fb7-ad19-8c375ce60da1",
"hotelName": "Delta Hotels Istanbul Halic",
"hotelClass": "****",
"cityId": "e1344ba0-5273-4fc1-b6c4-72446260f430",
"cityName": "Istanbul",
"countryCode": "TR",
"districtId": "24528bb1-a6d9-4514-8d92-754056a9f48e",
"districtName": "Kagytkhane",
"note": ""
},
"adults": 1,
"children": 0,
"childrenAges": "",
"childrenExeptInfants": 0,
"checkInDate": "2024-05-06T00:00:00",
"checkOutDate": "2024-05-07T00:00:00",
"includedExtrasAmount": 0,
"extraServices": []
}
],
"error": false
}
Definition of Response Parameters
| Parameter | value | Description |
| { | ||
| "resultID" | 1656436810005000001, | Unique ID of the Result |
| "hotelID" | 871186, | Unique ID of the hotel |
| "providerID" | 5, | provider id - (system internal) |
| "roomCategoryCode" | "ECO", | Special code for Room Category type |
| "roomCategoryName" | "Economic Room", | Name of the Room Category Type - definition of the "roomCategoryCode" |
| "mealPlanName" | "BB", | Meal Plan code |
| "placementType" | 1, | Placement type code - in this case 1 means single |
| "placementTypeName" | "1 Adult", | Placement type name - definition of the "placementType" |
| "priceCode" | "BASERATE BB ECO", | price code for the current option |
| "priceCurrency" | "EUR", | |
| "priceCurrencySrc" | "EUR", | |
| "availability" | 3, | Availability |
| "availableRoomsCount" | 1, | Number of available rooms for the current type of options |
| "totalSellPriceSrc" | 40.70, | |
| "totalSellPrice" | 40.70, | |
| "totalPriceSurcharge" | 0.00, | |
| "cancellationPolicyDescription" | "Cancellation Policy Non refundable", | TEXT DESCRIPTION OF THE CANCELLATION POLICY |
| "cancellationPolicy" | { | |
| "noShowChargeValue" | 100.00, | |
| "noShowChargeValueType" | "%", | |
| "earlyDepartureChargeValue" | 100.00, | |
| "earlyDepartureChargeValueType" | "%", | |
| "conditions" | [ | |
| { | ||
| "timeunits" | 365, | |
| "timeunitType" | "Day", | |
| "timeOffsetTypeName" | "Before Arrival", | |
| "chargeValue" | 100.00, | |
| "chargeValueType" | "%" | |
| } | ||
| ] | ||
| }, | ||
| "searchId" | 1656436810, | search id of the hotel |
| "hotelCode" | "10b7bc34-2a03-495e-94bc-1092b07823f7", | Unique ID of the Hotel. Full List of the hotels is available in Get Hotels method |
| "id" | 1656436810005000001, | |
| "hotel" | { | |
| "hotelCode" | "10b7bc34-2a03-495e-94bc-1092b07823f7", | Unique ID of the Hotel. Full List of the hotels is available in Get Hotels method |
| "hotelName" | "Istanbul Holiday Hotel", | Full name of the Hotel |
| "hotelClass" | "***", | Hotel Class in Stars |
| "cityId" | "e1344ba0-5273-4fc1-b6c4-72446260f430", | Code of the city where hotel is located, which is available in method Get Cities in parameter [cityid] |
| "cityName" | "Istanbul", | Full Name of the City |
| "countryCode" | "TR", | Country code, which can be retrieved in Get Cities method, in parameter [countrycode] |
| "districtId" | "6ca0ed7e-7412-4e45-85b5-dd0d74cabc62", | District unique code, where hotel is located. |
| "districtName" | "Fatih", | Full name of the District |
| "note" | "" | Hotel note - this is optional |
| }, | ||
| "adults" | 1, | Number of the adults |
| "children" | 0, | Number of the children |
| "childrenAges" | "", | in case of children, here will be their ages |
| "childrenExeptInfants" | 0, | |
| "checkInDate" | "2024-05-06T00000", | date of the check in |
| "checkOutDate" | "2024-05-07T00000", | date of the check out |
| "includedExtrasAmount" | 0, | |
| "extraServices" | [] | |
| }, |