Validate a hotel rate

Re-price a room rate right before booking to confirm it is still available at the quoted price.

POST/v2/Hotel/HotelCheckRate

Access requires the permission hotel_check_rate

Call this at the moment the traveller confirms. Pass the FareSourceCode of the chosen room rate. The response confirms the rate and may return an updated FareSourceCode. Book with the code this call returns.

Two versions. The v1 path /Hotel/HotelCheckRate behaves the same. New integrations should use the v2 path above.

Path parameters

None.

Query parameters

None.

Body parameters

Name	Type	Required	Description
`SessionId`	string	Yes	Your session id. The validated rate is cached against it for 15 minutes.
`FareSourceCode`	string	Yes	The room-rate code from availability in hotel mode.

Request

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

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

const data = await res.json();

import requests

res = requests.post(
    "https://api.hermeseus.com/api/v2/Hotel/HotelCheckRate",
    json={
        "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
        "FareSourceCode": "YmE6OTk4MjE6cnI3ZjMy",
    },
)

data = res.json()

Response

Field	Type	Description
`Success`	boolean	`true` when the rate is still bookable.
`PricedItinerary`	object	The confirmed rate, including the `FareSourceCode` to book with and the price to charge.
`Error`	object	`null` on success.

{
  "Success": true,
  "PricedItinerary": {
    "FareSourceCode": "YmE6OTk4MjE6cnI3ZjMy",
    "HotelId": 7825691,
    "NetRate": 148.00,
    "Currency": "USD",
    "NonRefundable": false
  },
  "Error": null
}

Book within 15 minutes. The validated rate holds for up to 15 minutes. Book with the returned FareSourceCode before it lapses. If it changed, show the traveller the new price before charging.

Errors

Code	Meaning	Fix
`Err0106001`	`FareSourceCode` is missing.	Send the code from availability.
`Err0102003`	The rate is no longer available.	Search again.

Next step. Hold the room with book using the returned FareSourceCode.