Reservation List

POST

/api/v1/generic-api-service/royal/hotel/book/list?page=0&size=100

The reservation list endpoint shows all the reservations of the agency/sales channel.

cURL

curl --location 'https://test-api.etscore.com/api/v1/generic-api-service/royal/hotel/book/list?page=0&size=100' \
--header 'Accept-Language: en-us' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data '{
    "filterType" :"creation",
    "from": "2025-01-01",
    "to": "2025-03-31"
}'

Request

{
    "filterType" :"creation",
    "from": "2025-02-18",
    "to": "2025-02-19"
}

Response

{
    "reservations": [
        {
            "voucher": "ETSR204898808",
            "status": "CANCELLED_PENALTY",
            "bookingNumber": "114332415",
            "bookDetailPriceResponse": {
                "amount": 200.74,
                "currency": "EUR"
            },
            "bookDetailCommissionPriceResponse": {
                "currency": "EUR"
            },
            "clientReferenceId": "EtscoreRefID4465",
            "hotelCode": "sxk9jqw4pthy",
            "hotelConfirmationNumber": "114332415",
            "checkIn": "2025-03-22",
            "checkOut": "2025-03-23",
            "saleDate": "2025-02-18T16:16:39.970496"
        },
        {
            "voucher": "ETSR204902101",
            "status": "CANCELLED",
            "bookingNumber": "114335724",
            "bookDetailPriceResponse": {
                "amount": 89.25,
                "currency": "EUR"
            },
            "bookDetailCommissionPriceResponse": {
                "currency": "EUR"
            },
            "clientReferenceId": "Etscore112121",
            "hotelCode": "sxk9mgrrxqd7-516909",
            "hotelConfirmationNumber": "ETSR204902101",
            "checkIn": "2025-06-09",
            "checkOut": "2025-06-11",
            "saleDate": "2025-02-19T17:03:17.234603"
        },
        {
            "voucher": "ETSR204902139",
            "status": "RESERVATION",
            "bookingNumber": "114335763",
            "bookDetailPriceResponse": {
                "amount": 89.25,
                "currency": "EUR"
            },
            "bookDetailCommissionPriceResponse": {
                "currency": "EUR"
            },
            "clientReferenceId": "Etscore112122",
            "hotelCode": "sxk9mgrrxqd7-516909",
            "hotelConfirmationNumber": "ETSR204902139",
            "checkIn": "2025-06-09",
            "checkOut": "2025-06-11",
            "saleDate": "2025-02-19T17:15:01.630932"
        },
        {
            "voucher": "ETSR204898732",
            "status": "CANCELLED",
            "bookingNumber": "114332341",
            "bookDetailPriceResponse": {
                "amount": 195.00,
                "currency": "EUR"
            },
            "bookDetailCommissionPriceResponse": {
                "currency": "EUR"
            },
            "clientReferenceId": "EtscoreRefID4132",
            "hotelCode": "sxk9jqw4pthy",
            "hotelConfirmationNumber": "114332341",
            "checkIn": "2025-03-22",
            "checkOut": "2025-03-23",
            "saleDate": "2025-02-18T15:58:19.202871"
        },
        {
            "voucher": "ETSR204898736",
            "status": "CANCELLED",
            "bookingNumber": "114332345",
            "bookDetailPriceResponse": {
                "amount": 200.74,
                "currency": "EUR"
            },
            "bookDetailCommissionPriceResponse": {
                "currency": "EUR"
            },
            "clientReferenceId": "EtscoreRefID3160",
            "hotelCode": "sxk9jqw4pthy",
            "hotelConfirmationNumber": "114332345",
            "checkIn": "2025-03-22",
            "checkOut": "2025-03-23",
            "saleDate": "2025-02-18T15:58:53.724599"
        },
        {
            "voucher": "ETSR204898868",
            "status": "CANCELLED",
            "bookingNumber": "114332474",
            "bookDetailPriceResponse": {
                "amount": 200.74,
                "currency": "EUR"
            },
            "bookDetailCommissionPriceResponse": {
                "currency": "EUR"
            },
            "clientReferenceId": "EtscoreRefID6637",
            "hotelCode": "sxk9jqw4pthy",
            "hotelConfirmationNumber": "114332474",
            "checkIn": "2025-03-22",
            "checkOut": "2025-03-23",
            "saleDate": "2025-02-18T16:27:30.765324"
        }
    ]
}

Request Details

Name	Type	Required	Description
filterType	String	Yes	Enum: "creation" "check_in" "check_out" Parameter used to define whether start and end fields are filtering by check-in ,check-out date or by booking creation date.
from	String	Yes	Defines the starting date of the range of bookings to be returned.
to	String	Yes	Defines the ending date of the range of bookings to be returned. value.

Response Details

Name	Type	Required	Description
reservations	object-Array	Yes	Reservation list.
reservations/voucher	string	Yes	Voucher number that will be created in our system when the reservation is completed successfully.
reservations/status	string	Yes	Reservation status.
reservations/bookingNumber	string	Yes	Booking number that will be created in our system when the reservation is completed successfully
reservations/bookDetailPriceResponse	object	Yes	Price details of the reservation.
reservations/bookDetailPriceResponse/amount	int	Yes	Price amount of the reservation.
reservations/bookDetailPriceResponse/currency	string	Yes	Price currency of the reservation.
reservations/clientReference	string	No	[ 1 .. 20 ] characters. Internal booking reference.
reservations/hotelCode	string	Yes	It is the code of the hotel that the reservation is made.
reservations/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'.
reservations/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.
reservations/saleDate	string	Yes	This is the time when the reservation is complete.. It should be sent in the format 'YYYY-MM-DD hh:mm:ss tt'