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
| Method | Path | Auth |
|---|---|---|
POST | /v1/hotels/check/:gdsprovider | Required API key |
| Header | Description |
|---|---|
Authorization | Bearer <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-Type | Use application/json for requests with a body. |
Request Params Schema
| Property | Type | Details | Required | Notes |
|---|---|---|---|---|
gdsprovider | number | Yes | - |
Request Body Schema
| Property | Type | Details | Required | Notes |
|---|---|---|---|---|
offers | array | Yes | - | |
gdsprovider | number | Yes | - | |
hotelCode | string | Yes | - | |
rateKey | string | Yes | - | |
adults | number | Yes | - | |
children | number | Yes | - | |
name | string | Yes | - | |
board | string | Yes | - | |
totalPrice | number | Yes | - | |
originalPrice | number | No | - | |
currency | enum | EUR, USD, CNY | Yes | - |
originalCurrency | enum | EUR, USD, CNY | No | - |
supplements | array | Yes | - | |
description | string | Yes | - | |
price | number | Yes | - | |
currency | string | Yes | - | |
cancellationPolicies | array | Yes | - | |
amount | number | Yes | - | |
fromDate | string | Format: ISO 8601 | Yes | - |
isRefundable | boolean | Yes | - | |
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
| Property | Type | Details | Required | Notes |
|---|---|---|---|---|
available | boolean | Yes | - | |
ratesConditions | array | Yes | - | |
rateKey | string | Yes | - | |
conditions | array | Yes | - | |
conditions[] | string[] | Yes | - | |
pricesChanged | array | Yes | - | |
rateKey | string | Yes | - | |
newPrice | array | Yes | - | |
newPrice[] | number[] | Yes | - | |
ratesUnavailable | array | Yes | - | |
rateKey | string | Yes | - | |