BookingReservations
Endpoint
Sección titulada «Endpoint»POST {base_url}/1.0/bookings/reservationsLista las reservas creadas en un rango de fechas, con un resumen de cada una.
Headers
Sección titulada «Headers»| Header | Valor |
|---|---|
Authorization |
Bearer <access_token> |
Content-Type |
application/json |
Accept |
application/json |
Request body
Sección titulada «Request body»{ "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.
Response
Sección titulada «Response»{ "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.
Response fields
Sección titulada «Response fields»| 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.
Use cases
Sección titulada «Use cases»- Listar las reservas creadas en un rango de fechas. La lista puede incluir reservas canceladas: revisa
statusen cada entrada. - Cotejar las reservas con tus propios registros mediante
clientReference, filtrando la lista de tu lado.
Recommendations
Sección titulada «Recommendations»- Pide el rango más estrecho que cubra lo que necesitas.
- Evita los rangos amplios y el polling a este endpoint.

