POST/v1/hotels/offers

Get hotel room offers

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

Required headers:

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 Parameters

No path or query params are required.

Request Body

Field	Type	Required
`language`	enum	No
`gdsprovider`	`1` or `3`	Yes
`hotelCode`	string	Yes
`checkIn`	`YYYY-MM-DD`	Yes
`checkOut`	`YYYY-MM-DD`	Yes
`countryCode`	string	Yes
`guestNationality`	string	No
`minRatePrice`	number	No
`maxRatePrice`	number	No
`rooms`	room[]	Yes

Request Body Schema

language

enum

eneszh

Default en

gdsprovider

numberYes

hotelCode

stringYes

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

numberNo

maxRatePrice

numberNo

rooms

arrayYes

rooms[]adults

numberYes

Minimum value: 1, Maximum value: 4

rooms[]children

numberNo

Minimum value: 0, Maximum value: 4

rooms[]childrenAges

arrayYes

rooms[]childrenAges[]

number[]Yes

currency

enum

EURUSDCNY

Default EUR

Success Response

Returns hotel rooms, rates, cancellation policies and provider offer identifiers.

Response Body Schema

offers

arrayYes

offers[]roomNames

arrayYes

offers[]roomNames[]

string[]Yes

offers[]minPrice

numberYes

offers[]rates

arrayYes

offers[]rates[]gdsprovider

numberYes

offers[]rates[]hotelCode

stringYes

offers[]rates[]rateKey

stringYes

offers[]rates[]adults

numberYes

offers[]rates[]children

numberYes

offers[]rates[]name

stringYes

offers[]rates[]nameKey

stringYes

offers[]rates[]board

stringYes

offers[]rates[]boardKey

stringYes

offers[]rates[]totalPrice

numberYes

offers[]rates[]netPrice

numberYes

offers[]rates[]originalPrice

numberYes

offers[]rates[]currency

enum

EURUSDCNY

Yes

offers[]rates[]originalCurrency

enum

EURUSDCNY

Yes

offers[]rates[]supplements

arrayYes

offers[]rates[]supplements[]description

stringYes

offers[]rates[]supplements[]price

numberYes

offers[]rates[]supplements[]currency

stringYes

offers[]rates[]cancellationPolicies

arrayYes

offers[]rates[]cancellationPolicies[]amount

numberYes

offers[]rates[]cancellationPolicies[]fromDate

string

Format: ISO 8601

Yes

offers[]rates[]isRefundable

booleanYes

offers[]rates[]numberOfRooms

numberYes

offers[]rates[]adultsPerRoom

arrayYes

offers[]rates[]adultsPerRoom[]

number[]Yes

liveMode

booleanYes

True when the request is served by the live Travelandz environment. This value comes from Travelandz, not the provider payload.

Example

bash

curl -X POST https://api.sandbox.travelandz.com/v1/hotels/offers \
  -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>'