POST/v1/hotels/check/:gdsprovider

Revalidate hotel offer

Revalidates selected hotel room offers before booking to confirm availability, price changes and booking eligibility.

Revalidates selected hotel room offers before booking to confirm availability, price changes and booking eligibility.

Endpoint

MethodPathAuth
POST/v1/hotels/check/:gdsproviderRequired API key
Required headers:
HeaderDescription
AuthorizationBearer <secret_key>. The secret is shown only once when the credential is created.
X-Travelandz-Id<public_key>:<profile_code>. The profile_code is the dp_-prefixed Developer Profile code shown in your dashboard. This binds the request to a profile and credential.
Content-TypeUse application/json for requests with a body.

Request Params Schema

PropertyTypeDetailsRequiredNotes
gdsprovidernumberYes-

Request Body Schema

PropertyTypeDetailsRequiredNotes
offersarrayYes-
gdsprovidernumberYes-
hotelCodestringYes-
rateKeystringYes-
adultsnumberYes-
childrennumberYes-
namestringYes-
boardstringYes-
totalPricenumberYes-
originalPricenumberNo-
currencyenumEUR, USD, CNYYes-
originalCurrencyenumEUR, USD, CNYNo-
supplementsarrayYes-
descriptionstringYes-
pricenumberYes-
currencystringYes-
cancellationPoliciesarrayYes-
amountnumberYes-
fromDatestringFormat: ISO 8601Yes-
isRefundablebooleanYes-
checkInstringFormat: YYYY-MM-DDYes-
checkOutstringFormat: YYYY-MM-DDYes-

Success Response

Returns the revalidated rate, price and booking eligibility.

Response Body Schema

PropertyTypeDetailsRequiredNotes
availablebooleanYes-
ratesConditionsarrayYes-
rateKeystringYes-
conditionsarrayYes-
conditions[]string[]Yes-
pricesChangedarrayYes-
rateKeystringYes-
newPricearrayYes-
newPrice[]number[]Yes-
ratesUnavailablearrayYes-
rateKeystringYes-