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-
offers[]gdsprovider
numberYes-
offers[]hotelCode
stringYes-
offers[]rateKey
stringYes-
offers[]adults
numberYes-
offers[]children
numberYes-
offers[]name
stringYes-
offers[]board
stringYes-
offers[]totalPrice
numberYes-
offers[]originalPrice
numberNo-
offers[]currency
enum
EURUSDCNY
Yes-
offers[]originalCurrency
enum
EURUSDCNY
No-
offers[]supplements
arrayYes-
offers[]supplements[]description
stringYes-
offers[]supplements[]price
numberYes-
offers[]supplements[]currency
stringYes-
offers[]cancellationPolicies
arrayYes-
offers[]cancellationPolicies[]amount
numberYes-
offers[]cancellationPolicies[]fromDate
string
Format: ISO 8601
Yes-
offers[]isRefundable
booleanYes-
checkInstring
Format: YYYY-MM-DD
Yes-
checkOutstring
Format: YYYY-MM-DD
Yes-

Success Response

Returns the revalidated rate, price and booking eligibility.

Response Body Schema

PropertyTypeDetailsRequiredNotes
availablebooleanYes-
ratesConditionsarrayYes-
ratesConditions[]rateKey
stringYes-
ratesConditions[]conditions
arrayYes-
ratesConditions[]conditions[]
string[]Yes-
pricesChangedarrayYes-
pricesChanged[]rateKey
stringYes-
pricesChanged[]newPrice
arrayYes-
pricesChanged[]newPrice[]
number[]Yes-
ratesUnavailablearrayYes-
ratesUnavailable[]rateKey
stringYes-