• VillaSlotDocumentation
  • Introduction
  • Getting Started
  • API
    • Discovery
      • GETGet my context
    • Villas
      • GETList villas
      • POSTCreate a villa
      • GETGet a villa
      • PATCHRename a villa
      • POSTArchive a villa
      • POSTUpload a villa photo
      • GETGet opening hours
      • PUTReplace opening hours
      • GETGet the rate grid
      • PUTReplace the rate grid
      • GETGet availability
    • Bookings
      • GETList bookings over a period
      • POSTCreate a booking
      • GETGet a booking
      • POSTConfirm a booking
      • POSTComplete a booking
      • POSTCancel a booking
      • POSTReschedule a booking
    • Customers
      • GETList customers
      • POSTCreate a customer
      • POSTImport a batch of customers
      • GETGet a customer
      • PATCHUpdate a customer
    • Booking settings
      • GETGet booking settings
      • PATCHUpdate booking settings
  1. Documentation
  2. API
  3. Villas
  4. Get the rate grid
Buydocschangelogsdemocommunity

Get the rate grid

PreviousReplace opening hoursNextReplace the rate grid
On this page
AuthorizationExampleResponseWhat it refuses

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

Role in the organizationThis endpoint
ownerAllowed
adminAllowed
memberAllowed

Example

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

Response

  • 200 OK — the priced durations.
json
{
  "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.