POST/v1/hotels/search

Search available hotels

Searches available hotels by location, dates, occupancy and commercial filters, then applies company-level pricing rules.

Endpoint

Method	Path	Auth
`POST`	`/v1/hotels/search`	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 Schema

language

enum

eneszh

Default en

checkIn

string

Format: YYYY-MM-DD

Yes

checkOut

string

Format: YYYY-MM-DD

Yes

location

objectYes

locationsearchBy

enum

coords

Yes

locationlatitude

numberYes

locationlongitude

numberYes

searchRadius

numberNo

Minimum value: 1

countryCode

string

Format: 2 digits

Yes

nationality

string

Format: 2 digits

Yes

maxHotels

numberNo

Maximum value: 2000

minRate

numberNo

maxRate

numberNo

minCategory

enum

12345

maxCategory

enum

12345

refundable

enum

allrefundablenon-refundable

Yes

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

retrieveBookingLink

booleanNo

Default false

Success Response

Returns hotel results, availability, min rates and optional booking links.

Response Body Schema

hotels

arrayYes

hotels[]gdsprovider

numberYes

hotels[]offerLink

stringNo

hotels[]hotelId

stringYes

hotels[]code

stringYes

hotels[]name

stringYes

hotels[]description

objectYes

hotels[]descriptionlang

enum

eneszh

Yes

hotels[]descriptiondescription

stringYes

hotels[]starRating

numberYes

hotels[]reviewCount

numberNo

hotels[]accommodationType

stringYes

hotels[]chain

stringNullable

hotels[]address

objectYes

hotels[]addressstreet

stringNo

hotels[]addresscountryCode

stringNo

hotels[]addresscountry

stringNo

hotels[]addressdestination

stringNo

hotels[]addresszone

stringNo

hotels[]location

objectYes

hotels[]locationtype

stringYes

hotels[]locationcoordinates

arrayYes

hotels[]locationcoordinates[]

number[]

Format: [longitude, latitude]

Yes

hotels[]latitude

numberYes

hotels[]longitude

numberYes

hotels[]roomsNames

arrayYes

hotels[]roomsNames[]

string[]Yes

hotels[]boardTypes

arrayYes

hotels[]boardTypes[]

string[]Yes

hotels[]hasRefundableRooms

booleanYes

hotels[]images

arrayYes

hotels[]images[]

string[]Yes

hotels[]amenities

arrayYes

hotels[]amenities[]

string[]Yes

hotels[]minPrice

numberYes

hotels[]roomCount

numberNo

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/search \
  -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>'