POST/v1/hotels/search

Buscar hoteles disponibles

Busca hoteles disponibles por ubicación, fechas, ocupación y filtros comerciales, y aplica las reglas de precio configuradas para la compañía.

Endpoint

Método	Ruta	Auth
`POST`	`/v1/hotels/search`	API key requerida

Headers obligatorios:

Header	Descripción
`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.

Propiedad	Tipo	Detalles	Requerido	Notas
`language`	`enum`	`eneszh`	No	Default en
`checkIn`	`string`	`Format: YYYY-MM-DD`	Sí	-
`checkOut`	`string`	`Format: YYYY-MM-DD`	Sí	-
`location`	`object`		Sí	-
`locationsearchBy`	`enum`	`coords`	Sí	-
`locationlatitude`	`number`		Sí	-
`locationlongitude`	`number`		Sí	-
`searchRadius`	`number`		No	Minimum value: 1
`countryCode`	`string`	`Format: 2 digits`	Sí	-
`nationality`	`string`	`Format: 2 digits`	Sí	-
`maxHotels`	`number`		No	Maximum value: 2000
`minRate`	`number`		No	-
`maxRate`	`number`		No	-
`minCategory`	`enum`	`12345`	No	-
`maxCategory`	`enum`	`12345`	No	-
`refundable`	`enum`	`allrefundablenon-refundable`	Sí	-
`rooms`	`array`		Sí	-
`rooms[]adults`	`number`		Sí	Minimum value: 1, Maximum value: 4
`rooms[]children`	`number`		No	Minimum value: 0, Maximum value: 4
`rooms[]childrenAges`	`array`		Sí	-
`rooms[]childrenAges[]`	`number[]`		Sí	-

`currency`	`enum`	`EURUSDCNY`	No	Default EUR
`retrieveBookingLink`	`boolean`		No	Default false

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

Propiedad	Tipo	Detalles	Requerido	Notas
`hotels`	`array`		Sí	-
`hotels[]gdsprovider`	`number`		Sí	-
`hotels[]offerLink`	`string`		No	-
`hotels[]hotelId`	`string`		Sí	-
`hotels[]code`	`string`		Sí	-
`hotels[]name`	`string`		Sí	-
`hotels[]description`	`object`		Sí	-
`hotels[]descriptionlang`	`enum`	`eneszh`	Sí	-
`hotels[]descriptiondescription`	`string`		Sí	-
`hotels[]starRating`	`number`		Sí	-
`hotels[]reviewCount`	`number`		No	-
`hotels[]accommodationType`	`string`		Sí	-
`hotels[]chain`	`string`		Nulable	-
`hotels[]address`	`object`		Sí	-
`hotels[]addressstreet`	`string`		No	-
`hotels[]addresscountryCode`	`string`		No	-
`hotels[]addresscountry`	`string`		No	-
`hotels[]addressdestination`	`string`		No	-
`hotels[]addresszone`	`string`		No	-
`hotels[]location`	`object`		Sí	-
`hotels[]locationtype`	`string`		Sí	-
`hotels[]locationcoordinates`	`array`		Sí	-
`hotels[]locationcoordinates[]`	`number[]`	`Format: [longitude, latitude]`	Sí	-

`hotels[]latitude`	`number`		Sí	-
`hotels[]longitude`	`number`		Sí	-
`hotels[]roomsNames`	`array`		Sí	-
`hotels[]roomsNames[]`	`string[]`		Sí	-

`hotels[]boardTypes`	`array`		Sí	-
`hotels[]boardTypes[]`	`string[]`		Sí	-

`hotels[]hasRefundableRooms`	`boolean`		Sí	-
`hotels[]images`	`array`		Sí	-
`hotels[]images[]`	`string[]`		Sí	-

`hotels[]amenities`	`array`		Sí	-
`hotels[]amenities[]`	`string[]`		Sí	-

`hotels[]minPrice`	`number`		Sí	-
`hotels[]roomCount`	`number`		No	-