Listar las reservas de un periodo

GET /api/v1/bookings

Las reservas de la organización en un periodo. from y to son obligatorios: el producto lee un calendario, y no hay listado sin límites.

Autorización

Parámetros de consulta

Ejemplo

curl -H "x-api-key: $VILLASLOT_API_KEY" \
  "https://villaslot.app/api/v1/bookings?from=2026-09-01T00:00:00Z&to=2026-09-30T23:59:59Z"

Respuesta

• 200 OK — el periodo, su zona horaria y su moneda, y las reservas. Cada reserva lleva propertyName, customerName y blocksSlot.

{
  "success": true,
  "data": {
    "from": "2026-09-01T00:00:00.000Z",
    "to": "2026-09-30T23:59:59.000Z",
    "timezone": "Asia/Makassar",
    "currency": "IDR",
    "bookings": [
      {
        "id": "5b2c…",
        "propertyId": "1f0a…",
        "propertyName": "Villa Suar",
        "customerId": "8d3e…",
        "customerName": "Tomas Lindqvist",
        "startAt": "2026-09-12T05:00:00.000Z",
        "endAt": "2026-09-12T07:00:00.000Z",
        "kind": "SHOOT",
        "status": "CONFIRMED",
        "paymentStatus": "PARTIALLY_PAID",
        "priceAmount": 2800000,
        "currency": "IDR",
        "depositPercent": 30,
        "bufferMinutes": 30,
        "holdExpiresAt": null,
        "blocksSlot": true
      }
    ]
  }
}

Qué rechaza

• 422 Unprocessable Entity — from o to ausente o ilegible.
• 401 Unauthorized — clave ausente o no válida, o clave cuyo portador ha dejado la organización.
• 404 Not Found — identificador desconocido, o identificador que pertenece a otra organización. Los dos son deliberadamente indistinguibles.
• 429 Too Many Requests — más de 120 peticiones en un minuto para esta clave.

Notas

• blocksSlot es la respuesta del motor, no una columna: una reserva cancelada o caducada sigue visible pero ya no ocupa su franja, y una reserva provisional la ocupa o no según la regla de la organización.
• El token del enlace del cliente de una reserva nunca se devuelve: es el título de acceso del cliente a su propia página.