POST/v1/hotels/check/:gdsprovider

Revalidate hotel offer

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

Share

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

gdsprovider
numberYes

Request Body

Send the provider offer/rate payload returned by hotel offers.

Request Body Schema

offers
arrayYes
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
checkIn
string
Format: YYYY-MM-DD
Yes
checkOut
string
Format: YYYY-MM-DD
Yes

Success Response

Returns the revalidated rate, price and booking eligibility.

Response Body Schema

available
booleanYes
ratesConditions
arrayYes
ratesConditions[]rateKey
stringYes
ratesConditions[]conditions
arrayYes
ratesConditions[]conditions[]
string[]Yes
pricesChanged
arrayYes
pricesChanged[]rateKey
stringYes
pricesChanged[]newPrice
arrayYes
pricesChanged[]newPrice[]
number[]Yes
ratesUnavailable
arrayYes
ratesUnavailable[]rateKey
stringYes
liveMode
booleanYes
True when the request is served by the live Travelandz environment. This value comes from Travelandz, not the provider payload.

Example

bash
bash
curl -X POST https://api.sandbox.travelandz.com/v1/hotels/check/:gdsprovider \
  -H "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  -H "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE" \
  -H "Content-Type: application/json" \
  -d '<request_body_json>'