GET /api/v1/properties
The villas of the key's organization. Archived villas are excluded by default — they no longer take new bookings.
| Role in the organization | This endpoint |
|---|---|
owner | Allowed |
admin | Allowed |
member | Allowed |
| Parameter | Type | Default | Description |
|---|---|---|---|
page | integer | 1 | Page number, from 1 |
limit | integer | 20 | Page size, capped at 100 |
search | string | — | Matches the villa name |
status | enum | active | active, archived or all |
curl -H "x-api-key: $VILLASLOT_API_KEY" \
"https://villaslot.app/api/v1/properties?limit=50&status=all"200 OK — the page, with pagination: {total, page, limit, totalPages}.{
"success": true,
"data": [
{
"id": "1f0a…",
"organizationId": "a379bb76-…",
"name": "Villa Suar",
"photoUrl": "https://…/villa.jpg",
"status": "active",
"nightlyRate": 4500000,
"createdAt": "2026-01-04T08:00:00.000Z",
"updatedAt": "2026-01-04T08:00:00.000Z"
}
],
"pagination": {"total": 4, "page": 1, "limit": 50, "totalPages": 1}
}422 Unprocessable Entity — status is not one of the three accepted values.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.