API Reference

Price check

To complete the integration with Hotel Planet, the client must provide a webhook for price verification, as the Hotel Planet API requires a price check before proceeding with the booking.

Below is the payload that Hotel Planet sends to the webhook.

{
  "hotelId": "HOTEL123",
  "roomCount": 1,
  "adultCount": 2,
  "childAges": [5, 8],
  "roomId": "1010",
  "rateId": "1233",
  "checkin": "2025-04-15",
  "checkout": "2025-04-16"
}

And below is the expected response from the webhook.

{
  "roomRate": {
    "roomId": "1010",
    "rateId": "1233",
    "currency": "USD",
    "inventory": 6,
    "amountBeforeTax": [
      76.03
    ],
    "amountAfterTax": [
      91.41
    ],
    "mealPlan": "RO",
    "cancelPolicy": {
      "code": "1D1N_4PM0D1N_100P",
      "description": "Cancel 24 Hours prior to 4pm day of arrival to avoid 1 Night charge plus tax.",
      "cancelPenalties": [
        {
          "noShow": false,
          "cancelDeadline": {
            "offsetTimeUnit": "D",
            "offsetTimeValue": 1,
            "deadline": "4PM"
          },
          "penaltyCharge": {
            "chargeBase": "NightBase",
            "nights": 1
          }
        },
        {
          "noShow": true,
          "penaltyCharge": {
            "chargeBase": "FullStay",
             // in FullStay charge base, you can return percent or amount
            "percent": 100,
            "amount": 100
          }
        }
      ]
    }
  }
}
Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!