Get the rate grid

GET /api/v1/properties/{propertyId}/rates

The rate grid of a villa: one entry per priced duration.

A duration absent from the grid is not bookable for this villa — not even at a negotiated price. The grid says what the villa offers.

Amounts are integers in the minor unit of the organization currency (ADR 003): 1500000 in IDR is 15 000 rupiah, 4500 in EUR is 45,00 €. Never divide by 100 on your side without knowing the currency.

Authorization

Example

curl -H "x-api-key: $VILLASLOT_API_KEY" \
  "https://villaslot.app/api/v1/properties/1f0a…/rates"

Response

• 200 OK — the priced durations.

{
  "success": true,
  "data": [
    {"durationMinutes": 60, "amount": 1500000},
    {"durationMinutes": 120, "amount": 2800000}
  ]
}

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.