Listar las villas | VillaSlot Documentation

GET /api/v1/properties

Las villas de la organización de la clave. Las villas archivadas se excluyen por defecto — ya no aceptan nuevas reservas.

Autorización

Rol en la organización	Este endpoint
`owner`	Permitido
`admin`	Permitido
`member`	Permitido

Parámetros de consulta

Parámetro	Tipo	Por defecto	Descripción
`page`	entero	`1`	Número de página, desde 1
`limit`	entero	`20`	Tamaño de página, máximo 100
`search`	cadena	—	Busca en el nombre de la villa
`status`	enum	`active`	`active`, `archived` o `all`

Ejemplo

bash

curl -H "x-api-key: $VILLASLOT_API_KEY" \
  "https://villaslot.app/api/v1/properties?limit=50&status=all"

Respuesta

200 OK — la página, con pagination: {total, page, limit, totalPages}.

json

{
  "success": true,
  "data": [
    {
      "id": "1f0a…",
      "organizationId": "a379bb76-…",
      "name": "Villa Suar",
      "photoUrl": "https://…/villa.jpg",
      "status": "active",
      "nightlyRate": 4500000,
      "checkInMinute": 840,
      "checkOutMinute": 720,
      "createdAt": "2026-01-04T08:00:00.000Z",
      "updatedAt": "2026-01-04T08:00:00.000Z"
    }
  ],
  "pagination": {"total": 4, "page": 1, "limit": 50, "totalPages": 1}
}

checkInMinute y checkOutMinute son minutos locales en la zona horaria de la organización, de 0 a 1439. Los valores por defecto son 840 (14:00) y 720 (12:00). Cada villa tiene su propio par; las reservas existentes conservan sus instantes guardados. Configura las horas en los ajustes de la villa.

Qué rechaza

422 Unprocessable Entity — status no es uno de los tres valores aceptados.
401 Unauthorized — clave ausente o no válida, o clave cuyo portador ha dejado la organización.
404 Not Found — identificador desconocido, o identificador que pertenece a otra organización. Los dos son deliberadamente indistinguibles.
429 Too Many Requests — más de 120 peticiones en un minuto para esta clave.