Price Confirmation

About 542 wordsAbout 2 min

2026-03-27

POST Price Confirmation

This API is used to retrieve real-time pricing at the room level (price validation API).

This API must be called before creating a booking to perform a secondary price confirmation.

Endpoint

POST /rate/PriceConfirm?$format=json

Request Parameters

{
  "PreBook": true,
  "CheckInDate": "2025-12-22",
  "CheckOutDate": "2025-12-23",
  "HotelID": 1080044,
  "NumOfRooms": 1,
  "OccupancyDetails": [
    {
      "RoomNum": 1,
      "AdultCount": 1,
      "ChildCount": 1,
      "ChildAgeDetails": [0]
    }
  ],
  "Currency": "USD",
  "Nationality": "HK",
  "RatePlanID": "574308669677820045"
}

PreBook Description

Value	Description
true	Returns `ReferenceNo` (required for booking)
false	Price validation only (better performance)

Field	Type	Required	Description
HotelID	Number	Yes	Hotel ID
RatePlanID	String	Yes	Rate plan ID
CheckInDate	DateTime	Yes	Check-in date
CheckOutDate	DateTime	Yes	Check-out date
Nationality	String	No	Country code (default: CN)
NumOfRooms	Number	Yes	Number of rooms
OccupancyDetails	List	Yes	Occupancy details
PreBook	Boolean	Yes	Whether to pre-book
Currency	String	Yes	Currency
Metadata	String	No	Additional metadata

OccupancyDetails

Field	Type	Required	Description
RoomNum	Number	Yes	Room number (starting from 1)
AdultCount	Number	Yes	Number of adults
ChildCount	Number	Yes	Number of children
ChildAgeDetails	List	No	Children ages

Request Example

curl --location --request POST '{{domain}}/rate/PriceConfirm?$format=json' \
--header 'Authorization: PHT apikey={{api_key}},signature={{signature}},timestamp={{timestamp}}'  \
--header 'api_key: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "PreBook":true,
  "CheckInDate":"2025-12-22",
  "CheckOutDate":"2025-12-23",
  "HotelID":1080044,
  "NumOfRooms":1,
  "OccupancyDetails":[
    {
      "RoomNum":1,
      "AdultCount":1,
      "ChildCount":1,
      "ChildAgeDetails":[0]
    }
  ],
  "Currency":"USD",
  "Nationality":"HK",
  "RatePlanID":"574308669677820045"
}'

Response Example

{
  "Success": {
    "PriceDetails": {
      "ReferenceNo": "15442173799",
      "CheckInDate": "2025-12-22 00:00:00",
      "CheckOutDate": "2025-12-23 00:00:00",
      "HotelList": [
        {
          "HotelID": 1080044,
          "HotelName": "贵族酒店 - 贝斯特韦斯特辛尼雀精选系列",
          "Destination": {
            "CityCode": "178305"
          },
          "TotalPrice": 154,
          "RatePlanList": [
            {
              "RoomOccupancy": {
                "RoomNum": 1,
                "AdultCount": 1,
                "ChildCount": 1,
                "ChildAgeDetails": [0]
              },
              "RoomTypeID": 4673056,
              "RatePlanID": "574308669677820045",
              "RatePlanName": "1 King Bed...",
              "Currency": "USD",
              "TotalPrice": 154,
              "PriceList": [
                {
                  "Price": 154,
                  "StayDate": "2025-12-22 00:00:00"
                }
              ]
            }
          ],
          "CancellationPolicyList": [
            {
              "LocalFromDate": "2026-03-24T23:00:00+07:00",
              "Amount": 154
            }
          ]
        }
      ]
    }
  }
}

Response Parameters

Field	Type	Required	Description
PriceDetails	Object	Yes	Price details
ReferenceNo	String	No	Booking reference number (when PreBook=true)
CheckInDate	DateTime	Yes	Check-in date
CheckOutDate	DateTime	Yes	Check-out date
HotelList	List	Yes	List of hotels

HotelList

Field	Type	Required	Description
HotelID	Number	Yes	Hotel ID
HotelName	String	Yes	Hotel name
Destination	Object	No	Destination info
TotalPrice	Decimal	Yes	Total price
RatePlanList	List	Yes	Rate plan list
CancellationPolicyList	List	No	Cancellation policies

RatePlanList (Core)

Field	Type	Required	Description
RoomOccupancy	Object	Yes	Occupancy info
RoomTypeID	Number	No	Room type ID
RoomName	String	No	Room name
RatePlanID	String	Yes	Rate plan ID
RatePlanName	String	Yes	Rate plan name
BedType	Number	No	Bed type
Currency	String	Yes	Currency
TotalPrice	Decimal	Yes	Total room price
PriceList	List	Yes	Daily prices
MealType	Number	Recommended	Meal type
MealAmount	Number	Recommended	Number of meals

PriceList

Field	Type	Required	Description
Price	Decimal	Yes	Daily price
StayDate	DateTime	Yes	Date
MealType	Number	No	Meal type
MealAmount	Number	No	Number of meals

Cancellation Policy

Field	Type	Required	Description
LocalFromDate	String	No	Local Hotel Time
Amount	Decimal	No	Penalty amount