POST/v1/hotels/offers
Get hotel room offers
Returns rooms, rates, board types and cancellation policies for a selected hotel and stay.
Returns rooms, rates, board types and cancellation policies for a selected hotel and stay.
Endpoint
| Method | Path | Auth |
|---|---|---|
POST | /v1/hotels/offers | 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 Body Schema
| Property | Type | Details | Required | Notes |
|---|---|---|---|---|
language | enum | en, es, zh | No | Default en |
gdsprovider | number | Yes | - | |
hotelCode | string | Yes | - | |
checkIn | string | Format: YYYY-MM-DD | Yes | - |
checkOut | string | Format: YYYY-MM-DD | Yes | - |
countryCode | string | Format: 2 digits | Yes | - |
guestNationality | string | Format: 2 digits | Yes | - |
minRatePrice | number | No | - | |
maxRatePrice | number | No | - | |
rooms | array | Yes | - | |
adults | number | Yes | Minimum value: 1, Maximum value: 4 | |
children | number | No | Minimum value: 0, Maximum value: 4 | |
childrenAges | array | Yes | - | |
childrenAges[] | number[] | Yes | - | |
currency | enum | EUR, USD, CNY | No | Default EUR |
Success Response
Returns hotel rooms, rates, cancellation policies and provider offer identifiers.
Response Body Schema
| Property | Type | Details | Required | Notes |
|---|---|---|---|---|
offers | array | Yes | - | |
roomNames | array | Yes | - | |
roomNames[] | string[] | Yes | - | |
minPrice | number | Yes | - | |
rates | array | Yes | - | |
gdsprovider | number | Yes | - | |
hotelCode | string | Yes | - | |
rateKey | string | Yes | - | |
adults | number | Yes | - | |
children | number | Yes | - | |
name | string | Yes | - | |
nameKey | string | Yes | - | |
board | string | Yes | - | |
boardKey | string | Yes | - | |
totalPrice | number | Yes | - | |
netPrice | number | Yes | - | |
originalPrice | number | Yes | - | |
currency | enum | EUR, USD, CNY | Yes | - |
originalCurrency | enum | EUR, USD, CNY | Yes | - |
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 | - | |
numberOfRooms | number | Yes | - | |
adultsPerRoom | array | Yes | - | |
adultsPerRoom[] | number[] | Yes | - | |