Reservation Detail

POST

/api/v1/generic-api-service/royal/hotel/book/detail

The reservation detail endpoint is used to display the details of the reservation.

cURL

curl --location 'https://test-api.etscore.com/api/v1/generic-api-service/royal/hotel/book/detail' \
--header 'Accept-Language: en-us' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data '{
    "reservationId": "ETSR2014683530"
}'

Request

{
    "reservationId": "ETSR2014683530"
}

Response

{
    "hotelName": "Hilton İstanbul Kozyatağı",
    "hotelAddress": "Kadıköy, İstanbul",
    "hotelPhone": "",
    "price": 222.13,
    "currency": "EUR",
    "voucher": "ETSR2014683530",
    "bookingUuid": "da05e93c-ee6e-40b6-acff-1fe816ac9c08",
    "bookingNumber": "114320535",
    "clientReferenceId": "Etscore158259112",
    "checkIn": "2025-04-09",
    "checkOut": "2025-04-11",
    "contactName": "Test",
    "contactPhone": "(+90) 5555555555",
    "paymentInfos": [
        {
            "taxFee": 0.00,
            "otherFees": 0.00,
            "hotelPrice": 222.13,
            "currency": "EUR",
            "paymentDate": "2025-03-13",
            "paymentMethod": "CASH_EUR",
            "paymentStatus": "true",
            "type": "SALES"
        }
    ],
    "additionalInfo": "Üst katlarda oda ricadır",
    "cancellationPolicies": [
        {
            "amount": 0,
            "currency": "EUR",
            "toDate": "2025-04-09T16:00:00",
            "fromDate": "2025-03-13T14:33:43.832628"
        },
        {
            "amount": 222.13,
            "currency": "EUR",
            "toDate": "2025-04-09T16:00:00",
            "fromDate": "2025-04-09T16:00:00"
        }
    ],
    "reservationDetails": [
        {
            "date": "2025-03-13",
            "status": "RESERVATION",
            "roomPrice": 222.13,
            "refundPrice": 222.13,
            "roomCode": "4216"
        }
    ],
    "guests": [
        {
            "name": "TestName",
            "surname": "TestSurname",
            "birthDate": "1990-02-09",
            "guidId": "c198b57d-dc6f-4a66-a380-cd9a72a176a1"
        },
        {
            "name": "TestName",
            "surname": "TestSurname",
            "birthDate": "1990-02-09",
            "guidId": "bdd12da3-882d-4be7-b8ff-ac6ea74d7ed4"
        },
        {
            "name": "TestName",
            "surname": "TestSurname",
            "birthDate": "2022-02-09",
            "guidId": "2813c3e9-1110-4315-8bb3-6756138c434d"
        }
    ],
    "room": [
        {
            "pax": {
                "adult": 2,
                "child": 1,
                "childAges": [
                    3
                ]
            },
            "roomCode": "4216",
            "roomName": "Twin, City View, ",
            "mealType": "BB",
            "nightlyPrices": [
                {
                    "date": "2025-04-09",
                    "amount": 111.07,
                    "currency": "EUR"
                },
                {
                    "date": "2025-04-10",
                    "amount": 111.07,
                    "currency": "EUR"
                }
            ],
            "confirmationCode": "ETSR2014683530230886",
            "rateId": "230886"
        }
    ],
    "userNotes": {
        "nearElevator": true,
        "noSmokeRoom": true,
        "nearGeneralArea": true,
        "upstairsRoom": true,
        "downstairsRoom": true,
        "babyBedRoom": false,
        "doubleBedRoom": false,
        "singleBedRoom": false,
        "disabledFriendRoom": false,
        "honeyMoonCouple": true
    },
    "hotelConfirmationNumber": "ETSR2014683530",
    "activities": []
}

Request Details

Name	Type	Required	Description
reservationId	string	No	Reservation id whose details will be displayed.
clientReferenceId	string	No	The internal booking reference must be unique and contain between 1 and 20 characters

Response Details

Name	Type	Required	Description
hotelName	string	Yes	Name of the hotel booked.
hotelAddress	string	Yes	Address of the hotel booked.
hotelPhone	string	Yes	Phone number of the hotel booked.
price	int	Yes	Reservation price
currency	string	Yes	Currency in which the reservation is completed.
voucher	string	Yes	Voucher number that will be created in our system when the reservation is completed successfully.
bookingUuid	string	Yes	It is a unique id that will be generated by us for each reservation.
bookingNumber	string	Yes	Booking number that will be created in our system when the reservation is completed successfully
clientReferenceId	string	No	The internal booking reference must be unique and contain between 1 and 20 characters
checkIn	string	Yes	Checkin date
checkOut	string	Yes	Checkout date
contactName	string	Yes	Contact person for reservation.
contactPhone	string	Yes	Phone number of the contact person for the reservation
paymentInfos	string	Yes	Payment information of reservation
paymentInfos/taxFee	string	Yes	Tax fee included in the reservation
paymentInfos/otherFees	string	Yes	Other fees included in the reservation
paymentInfos/hotelPrice	string	Yes	Hotel price of the reservation
paymentInfos/currency	string	Yes	Currency in which the payment is made.
paymentInfos/paymentDate	string	Yes	Payment date
paymentInfos/paymentMethod	string	Yes	Payment completion method
paymentInfos/paymentStatus	string	Yes	Payment status
additionalInfo	string	No	Additional information in the reservation, if any.
cancellationPolicies	string	Yes	Object to return information for cancellation policies.
cancellationPolicies/amount	decimal	No	Penalty amount to be paid
cancellationPolicies/currency	string	No	Penalty amount currency to be paid
cancellationPolicies/toDate	string	No	Cancellation policy is valid for UTC+03:00 time zone.
cancellationPolicies/fromDate	string	No	Cancellation policy is valid for UTC+03:00 time zone.
reservationDetails	string	Yes	Detailed information about the reservation
reservationDetails/date	string	Yes	Reservation date
reservationDetails/status	string	Yes	Reservation status
reservationDetails/roomPrice	string	Yes	Room price
reservationDetails/refundPrice	string	Yes	Refunded fee if reservation is cancelled.
reservationDetails/roomCode	string	Yes	Room code of the reservation
guests	string	Yes	This object must provide information about the guests staying in the reservation.
guests/name	string	Yes	Guest's name
guests/surname	string	Yes	Guest's surname
guests/birthDate	string	Yes	Guest's birthDate. It should be sent in the format 'YYYY-MM-DD'.
guests/guidId	string	Yes	Unique id that will be generated by us for each guest
room	Object-Array	Yes	It is the information of the room that was 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.
room/pax	Object-Array	Yes	The number of people about the reserved room should be included in this object.
room/pax/adult	int	Yes	The number of adults that will be accommodated.
room/pax/child	int	No	The number of children that will be accommodated.
room/pax/childAges	int-Array	No	If there are children in the reservation, ages of the children must be in this parameter
room/roomCode	string	Yes	Room code in Etstur structure.
room/roomName	string	Yes	Room name in Etstur structure.
room/mealType	string	Yes	Meal type in Etstur structure.
room/description	string	No	Room description in Etstur structure.
room/confirmationCode	string	Yes	Parameter to use when canceling a Refundable reservation.
room/nightlyPrices	object-Array	Yes	An object that allows the room's nightly prices to be displayed separately. and Price must be big decimal type.
room/nightlyPrices/date	string	Yes	Date of the day, date format must be YYYY-MM-DD
room/nightlyPrices/amount	decimal	Yes	Price amount of the day
room/nightlyPrices/currency	string	Yes	Information in which currency the reservation amount is in is returned with the 'currency' parameter.
room/roomType	string	Yes	Room type in Etstur structure.