Get a hotel booking

Read a hotel booking and its status, and extend the payment deadline on a held booking.

Get the booking

POST/v2/Hotel/HotelBookingData

Access requires the permission hotel_booking_data

Look a booking up by the UniqueId from book, or by your own ClientUniqueId. Send at least one.

Body parameters

Name	Type	Required	Description
`SessionId`	string	Yes	Your session id.
`UniqueId`	string	One of	The booking id from book.
`ClientUniqueId`	string	One of	Your own reference. Send at least one of the two.

curl -X POST https://api.hermeseus.com/api/v2/Hotel/HotelBookingData \
  -H "Content-Type: application/json" \
  -d '{
    "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
    "UniqueId": "HB-2026-004417"
  }'

const res = await fetch("https://api.hermeseus.com/api/v2/Hotel/HotelBookingData", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    SessionId: "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
    UniqueId: "HB-2026-004417"
  })
});

const data = await res.json();

import requests

res = requests.post(
    "https://api.hermeseus.com/api/v2/Hotel/HotelBookingData",
    json={
        "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
        "UniqueId": "HB-2026-004417",
    },
)

data = res.json()

Response

Field	Type	Description
`Success`	boolean	`true` on success.
`UniqueId`	string	The booking id.
`Status`	integer	Booking status code.
`HotelName`	string	The property.
`CheckIn` / `CheckOut`	string	Stay dates.
`NetRate`	number	Total charged. USD.
`Rooms`	array of object	Rooms and guests as booked.
`Error`	object	`null` on success.

{
  "Success": true,
  "UniqueId": "HB-2026-004417",
  "Status": 20,
  "HotelName": "Hotel Le Marais",
  "CheckIn": "2026-10-15",
  "CheckOut": "2026-10-16",
  "NetRate": 148.00,
  "Currency": "USD",
  "Rooms": [
    {
      "Passengers": [
        { "FirstName": "Jane", "LastName": "Doe", "PassengerType": 1 }
      ]
    }
  ],
  "Error": null
}

Extend the payment deadline

POST/v2/Hotel/HotelExtendPaymentDeadline

Access requires the permission hotel_extend_payment_deadline

Push the deadline out on a booking that is still held. Once confirmed, there is nothing to extend.

Body parameters

Name	Type	Required	Description
`SessionId`	string	Yes	Your session id.
`UniqueId`	string	Yes	The held booking id.

{
  "Success": true,
  "UniqueId": "HB-2026-004417",
  "PaymentDeadline": "2026-10-10T18:00:00",
  "Error": null
}

Two versions. The v1 paths /Hotel/HotelBookingData and /Hotel/HotelExtendPaymentDeadline are the same operations. New integrations should use the v2 paths above.

Errors

Code	Meaning	Fix
`Err0106002`	Neither `UniqueId` nor `ClientUniqueId` was sent.	Send at least one.
`Err0104002`	Hotel booking not found.	Check the id.
`Err0104003`	The payment deadline cannot be extended.	The booking is not in an extendable state.