Jump to Content

Price check

post

https://ari-dev.thehotelplanet.com/v1/push/webhook/availability

Register and implement a price-check webhook so Nuitee Cloud can validate live price and availability during the booking flow.

Recent Requests

Log in to see full request history

Time	Status	User Agent
Retrieving recent requests…

Loading…

Price-check webhook

Registration

Register your callback URL on the ARI gateway:

POST /v1/push/webhook/availability
x-api-key: YOUR_KEY
Content-Type: application/json

{ "webhook": "https://partner.example.com/hp/pricecheck" }

Success response:

{ "code": "200", "message": "Webhook request saved successfully" }

When Nuitee Cloud calls you

During the booking flow, after a guest selects a rate, Nuitee Cloud POSTs to your registered URL to confirm live price and availability before completing the booking.

Implement a low-latency HTTPS endpoint (target under 2 seconds — confirm SLA with onboarding).

Inbound payload (Nuitee Cloud → you)

Below is the payload that Nuitee Cloud 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"
}

Field	Description
`hotelId`	Supplier hotel code (same as `/push/hotels`)
`roomId` / `rateId`	Same codes as products and ARI
`checkin` / `checkout`	Stay dates
`roomCount`	Number of rooms
`adultCount`	Adults
`childAges`	Ages of children

Expected response (you → Nuitee Cloud)

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",
            "percent": 100,
            "amount": 100
          }
        }
      ]
    }
  }
}

For FullStay penalty charge base, you may return percent or amount.

Partner responsibilities

Return structured success/failure per the contract above
Use the same roomId and rateId mapping as static data and ARI
Log your own correlation IDs (the ARI gateway may not return requestId on all responses)

Failure handling

Confirm with Nuitee Cloud onboarding: webhook timeout, retries, and whether the booking is rejected if your endpoint fails or returns an error.

Responses

Language

Credentials

Header

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json