Ir al contenido

BookingReservations

POST {base_url}/1.0/bookings/reservations

Lista las reservas creadas en un rango de fechas, con un resumen de cada una.

Header Valor
Authorization Bearer <access_token>
Content-Type application/json
Accept application/json
{
"createdRange": {
"from": "2026-04-13",
"to": "2026-04-16"
}
}
Campo Tipo Descripción
createdRange object Rango de fechas de creación de la reserva
createdRange.from string Inicio del rango, YYYY-MM-DD
createdRange.to string Fin del rango, YYYY-MM-DD

En una muestra, el rango se aplicó a la fecha de creación de la reserva, no a la fecha de check-in.

{
"reservations": [
{
"id": 21204517,
"status": "CONFIRMED",
"dateSale": "2026-04-14T09:12:45.317",
"checkIn": "2027-05-15T00:00:00",
"clientReference": "10045",
"clientName": "John",
"clientSurname": "Smith",
"hotelId": 100652,
"hotelName": "Ocean View Cancun Arenas"
},
{
"id": 21204688,
"status": "CANCELLED",
"dateSale": "2026-04-15T16:03:08.25",
"checkIn": "2027-05-15T00:00:00",
"clientReference": "10046",
"clientName": "Maria",
"clientSurname": "Lopez",
"hotelId": 100652,
"hotelName": "Ocean View Cancun Arenas"
}
],
"eventId": "5b8e2f41-9a7c-4d3e-b1f6-2c0d8a9e7f13"
}

Este ejemplo es ilustrativo, no una captura: sigue la forma de una respuesta observada y sus valores no son reales.

Campo Tipo Notas
reservations array Reservas creadas en el rango
reservations[].id int ID de la reserva
reservations[].status string Estado de la reserva. En una muestra de seis entradas: CONFIRMED en cuatro y CANCELLED en dos. No asumas que son los únicos valores.
reservations[].dateSale string Fecha y hora de la venta, sin designador de zona horaria. En una muestra de seis entradas, la fracción de segundos tuvo tres dígitos en cuatro entradas, dos en una y uno en una. No asumas un número fijo de dígitos.
reservations[].checkIn string Fecha y hora de check-in, sin fracción de segundos ni designador de zona horaria, en las seis entradas de una muestra
reservations[].clientReference string Referencia del partner
reservations[].clientName string Nombre del titular
reservations[].clientSurname string Apellido del titular
reservations[].hotelId int ID del hotel
reservations[].hotelName string Nombre del hotel
eventId string ID de traza

Cada entrada es un resumen: no incluye check-out, importe, moneda, habitaciones ni políticas de cancelación. Para esos detalles, usa BookingGet.

Código HTTP Mensaje Causa Qué hacer
6102 400 Invalid range, only 31 days are allowed El mensaje indica que el rango no es válido y da un número de días permitidos; cómo se cuentan los días no está definido. Reduce el rango o divide el periodo en varias peticiones.

En una muestra, un rango en el que to caía 30 días después de from fue aceptado, y uno en el que to caía 31 días después de from fue rechazado con 6102. Cómo se cuentan los días no está definido.

Los demás códigos de error propios de este endpoint no están documentados. Para los códigos comunes a todos los endpoints, ver Error codes.

  • Listar las reservas creadas en un rango de fechas. La lista puede incluir reservas canceladas: revisa status en cada entrada.
  • Cotejar las reservas con tus propios registros mediante clientReference, filtrando la lista de tu lado.
  • Pide el rango más estrecho que cubra lo que necesitas.
  • Evita los rangos amplios y el polling a este endpoint.