POST/v1/hotels/book

Reservar hotel

Crea una reserva de hotel para habitaciones seleccionadas usando datos del titular, huéspedes, tarifas y estadía.

Endpoint

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

Headers obligatorios:

Header	Descripción
`Authorization`	`Bearer <secret_key>`. El secret se muestra una sola vez al crear la credencial.
`X-Travelandz-Id`	`<public_key>:<profile_code>`. El `profile_code` es el codigo de Developer Profile con prefijo `dp_` que ves en el dashboard. Esto vincula la peticion con un perfil y una credencial.
`Content-Type`	Usa `application/json` para peticiones con cuerpo.

Parámetros de la petición

No requiere parámetros de ruta ni query.

Esquema del cuerpo de la petición

gdsprovider

numberSí

hotelCode

stringSí

holder

objectSí

holdername

stringSí

holderlastName

stringSí

holderemail

stringSí

holderlanguage

stringNo

holderphone

stringNo

rooms

arraySí

rooms[]rateKey

stringSí

rooms[]roomName

stringSí

rooms[]roomBoard

stringSí

rooms[]cancellationPolicies

arraySí

rooms[]cancellationPolicies[]amount

numberSí

rooms[]cancellationPolicies[]fromDate

string

Format: ISO 8601

Sí

rooms[]ratePrice

numberSí

rooms[]priceRangeCurrency

enum

EURUSDCNY

rooms[]priceRangeMinimum

numberNo

Minimum of the 25% of the original price of the booking

rooms[]priceRangeMaximum

numberNo

Maximum of the 100% of the original price of the booking.

rooms[]passengers

arraySí

rooms[]passengers[]roomId

numberSí

rooms[]passengers[]title

enum

mrmsmrsmiss

Sí

rooms[]passengers[]type

enum

adultchild

Sí

rooms[]passengers[]name

stringSí

rooms[]passengers[]lastName

stringSí

rooms[]passengers[]nationality

string

Format: 2 digits

Sí

rooms[]passengers[]age

numberNo

rooms[]passengers[]gender

enum

fm

rooms[]checkIn

string

Format: YYYY-MM-DD

Sí

rooms[]checkOut

string

Format: YYYY-MM-DD

Sí

searchBody

objectSí

searchBodylanguage

enum

eneszh

Default en

searchBodygdsprovider

numberSí

searchBodyhotelCode

stringSí

searchBodycheckIn

string

Format: YYYY-MM-DD

Sí

searchBodycheckOut

string

Format: YYYY-MM-DD

Sí

searchBodycountryCode

string

Format: 2 digits

Sí

searchBodyguestNationality

string

Format: 2 digits

Sí

searchBodyminRatePrice

numberNo

searchBodymaxRatePrice

numberNo

searchBodyrooms

arraySí

searchBodyrooms[]adults

numberSí

Minimum value: 1, Maximum value: 4

searchBodyrooms[]children

numberNo

Minimum value: 0, Maximum value: 4

searchBodyrooms[]childrenAges

arraySí

searchBodyrooms[]childrenAges[]

number[]Sí

searchBodycurrency

enum

EURUSDCNY

Por defecto EUR

checkIn

string

Format: YYYY-MM-DD

Sí

checkOut

string

Format: YYYY-MM-DD

Sí

Respuesta exitosa

Devuelve booking reference, status, provider response and confirmation details when available.

Esquema del cuerpo de la respuesta

bookingReference

stringSí

clientReference

stringSí

liveMode

booleanSí

True cuando la peticion se sirve desde el entorno live de Travelandz. Este valor viene de Travelandz, no del payload del proveedor.

Errores

Estado	Código	Caso
`400`	`unable_to_execute_booking`	Provider could not execute the booking.
`400`	-	Invalid payload or provider error.
`401/403`	auth codes	Invalid credentials.
`500`	-	Internal error.

Ejemplo

bash

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