Ir al contenido

BookingGet

GET {base_url}/1.0/bookings/{bookingId}

Recupera los detalles completos de una reserva creada previamente.

Header Valor
Authorization Bearer <access_token>
Accept application/json
Parámetro Tipo Descripción
bookingId int ID numérico de reserva devuelto por BookingNew. No se puede usar clientReference en esta ruta.

La API no permite localizar una reserva por clientReference: no sustituye a bookingId y GET /1.0/bookings?clientReference=... no es una ruta disponible.

{
"id": 21198221,
"status": "CONFIRMED",
"hotels": [
{
"checkIn": "2027-05-15",
"checkOut": "2027-05-16",
"confirmationCode": "",
"id": 100652,
"name": "Ocean View Cancun Arenas",
"rooms": [
{
"roomName": "Standard",
"mealPlan": "All Inclusive",
"occupancy": {
"adults": 2,
"childrenAges": []
},
"primaryGuest": "Jane Doe"
}
]
}
],
"amount": 116.00,
"taxes": 16.00,
"currency": "USD",
"clientReference": "99999",
"client": {
"name": "Jane",
"surname": "Doe",
"contactData": [
{
"email": "jane.doe@example.com",
"phone": { "countryCode": "+52", "number": "5512312322" }
}
]
},
"dateSale": "2026-04-15T10:30:00Z",
"cancellationPolicies": [],
"eventId": "c3eb536d-6378-4f2f-a922-b231de1ecd47"
}
Campo Tipo Notas
id int ID de la reserva
status string CONFIRMED, CREATED o CANCELLED
hotels[].checkIn string Fecha de inicio de la estancia — ver la nota de abajo
hotels[].checkOut string Fecha de fin de la estancia — ver la nota de abajo
hotels[].confirmationCode string Número de confirmación del hotel. Es una cadena vacía mientras no esté disponible, incluso cuando el estado de la reserva es CONFIRMED.
hotels[].id int ID del hotel
hotels[].name string Nombre del hotel
hotels[].rooms array Habitaciones de la reserva
hotels[].rooms[].roomName string Nombre de la habitación
hotels[].rooms[].mealPlan string Descripción del plan de alimentos — ver la nota de abajo
hotels[].rooms[].occupancy object Ocupación de la habitación
hotels[].rooms[].occupancy.adults int Número de adultos
hotels[].rooms[].occupancy.childrenAges int[] Edades de los menores
hotels[].rooms[].primaryGuest string Nombre del huésped principal — ver la nota de abajo
amount float Total cobrado
taxes float Porción de impuestos del monto
currency string Código de moneda
clientReference string Referencia del partner. No permite localizar una reserva mediante la API.
client.* object Datos del titular
dateSale string Cuándo se completó la venta — ver la nota de abajo
cancellationPolicies array Ventanas de penalización (post-confirmación)
eventId string ID de traza. No lo trates como único por petición — ver BookingNew

Los valores observados de mealPlan son descripciones del plan de alimentos, como Room Only o Continental breakfast, no códigos. No trates mealPlan como un código.

En dos respuestas, primaryGuest contenía el nombre y apellido del titular de la reserva tomados de client. En una respuesta en la que se habían enviado nombres de pax en HotelRates (roomCriteria[].paxes[].name / surname), esos nombres no se reflejaron. No esperes que BookingGet los devuelva. En una respuesta en la que se había enviado roomCriteria en BookingHold, el primaryGuest de cada habitación fue el primer huésped de esa habitación (una muestra). Ver Guest data in the hold.

Una respuesta exitosa de BookingGet puede omitir la propiedad error; no la exijas.

Código HTTP Mensaje Causa Qué hacer
201 500 Invalid booking id / reservation number. Only numbers are allowed El bookingId de la ruta no es numérico Envía el bookingId numérico
1201 500 The itinerary does not contain valid services Reserva corrupta o problema de configuración del partner Contacta a PriceTravel con el request, el response y el eventId
1202 500 Locator’s not found for the requested channel Reserva no visible desde este channel Revisa el bookingId; si es correcto, contacta a PriceTravel con el request, el response y el eventId
  • Consultar el estado de una reserva tras un timeout o 5xx en BookingNew, cuando tienes su bookingId — ver la estrategia de reintento en BookingNew.
  • Mostrar los detalles de la reserva en la UI del partner.
  • Leer cancellationPolicies antes de llamar a BookingDelete para informar al usuario de la penalización.
  • cancellationPolicies puede ser [] una vez que pasó la ventana de cancelación.
  • Una reserva con status: CANCELLED sigue devolviendo los detalles completos — verifica status primero.