BookingGet
Endpoint
Sección titulada «Endpoint»GET {base_url}/1.0/bookings/{bookingId}Recupera los detalles completos de una reserva creada previamente.
Headers
Sección titulada «Headers»| Header | Valor |
|---|---|
Authorization |
Bearer <access_token> |
Accept |
application/json |
Parámetro de ruta
Sección titulada «Parámetro de ruta»| 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.
Respuesta
Sección titulada «Respuesta»{ "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"}Campos de la respuesta
Sección titulada «Campos de la respuesta»| 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.
Errores
Sección titulada «Errores»| 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 |
Casos de uso
Sección titulada «Casos de uso»- 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
cancellationPoliciesantes de llamar aBookingDeletepara informar al usuario de la penalización.
Comportamiento importante
Sección titulada «Comportamiento importante»cancellationPoliciespuede ser[]una vez que pasó la ventana de cancelación.- Una reserva con
status: CANCELLEDsigue devolviendo los detalles completos — verificastatusprimero.

