Lister les réservations d’une période

GET /api/v1/bookings

Les réservations de l’organisation sur une période. from et to sont obligatoires : le produit lit un calendrier, et il n’existe pas de liste sans bornes.

Autorisation

Paramètres de requête

Exemple

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"

Réponse

• 200 OK — la période, son fuseau horaire et sa devise, et les réservations. Chaque réservation porte propertyName, customerName et 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
      }
    ]
  }
}

Ce qu’il refuse

• 422 Unprocessable Entity — from ou to absent ou illisible.
• 401 Unauthorized — clé absente ou invalide, ou clé dont le porteur a quitté l’organisation.
• 404 Not Found — identifiant inconnu, ou identifiant appartenant à une autre organisation. Les deux sont volontairement indiscernables.
• 429 Too Many Requests — plus de 120 requêtes en une minute pour cette clé.

Notes

• blocksSlot est la réponse du moteur, pas une colonne : une réservation annulée ou expirée reste visible mais n’occupe plus son créneau, et une option l’occupe ou non selon le réglage de l’organisation.
• Le jeton du lien client d’une réservation n’est jamais renvoyé : c’est le titre d’accès du client à sa propre page.