DELETE/v1/hotels/book/:gdsprovider/:reference

Cancelar reserva de hotel

Cancela una reserva de hotel existente por proveedor y referencia, sujeto a políticas y estado de la reserva.

Endpoint

Método	Ruta	Auth
`DELETE`	`/v1/hotels/book/:gdsprovider/:reference`	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.

Esquema de parámetros de la petición

gdsprovider

numberSí

reference

stringSí

Cuerpo de la petición

No requiere cuerpo de petición.

Respuesta exitosa

Devuelve cancellation status and provider confirmation when available.

Errores

Estado	Código	Caso
`400`	`hotel_booking_already_cancelled`	Booking was already cancelled.
`400`	`unable_to_perform_hotel_booking_cancellation`	Provider could not cancel.
`404`	`hotel_booking_not_found`	Booking was not found.
`401/403`	auth codes	Invalid credentials.
`500`	-	Internal error.

Ejemplo

bash

curl -X DELETE https://api.sandbox.travelandz.com/v1/hotels/book/:gdsprovider/:reference \
  -H "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  -H "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE"

Respuestas

Código	Descripción
`204`	Booking cancelled successfully