Get booking settings

GET /api/v1/settings/booking

The booking rules of the key's organization.

configured matters. When it is false, nothing has been saved yet: currency is null and the other values are the product defaults, not a choice. No booking can be created until a currency is chosen.

Authorization

Example

curl -H "x-api-key: $VILLASLOT_API_KEY" \
  "https://villaslot.app/api/v1/settings/booking"

Response

• 200 OK — the settings.

{
  "success": true,
  "data": {
    "organizationId": "a379bb76-…",
    "currency": "IDR",
    "timezone": "Asia/Makassar",
    "timezoneConfigured": true,
    "bufferMinutes": 30,
    "holdExpirationHours": 24,
    "holdBlocksSlot": true,
    "publicBookingEnabled": false,
    "minimumNights": 1,
    "turnoverGuardEnabled": false,
    "turnoverGuardMinimumMinutes": 240,
    "configured": true,
    "updatedAt": "2026-01-04T08:00:00.000Z"
  }
}

What it refuses

• 401 Unauthorized — missing or invalid key, or a key whose bearer left the organization.
• 404 Not Found — unknown id, or an id belonging to another organization. The two are deliberately indistinguishable.
• 429 Too Many Requests — over 120 requests in a minute for this key.