Propietarios

El arrendador de cada propiedad — sus datos aparecen en el contrato. Un propietario puede gestionar varias propiedades.

El objeto propietario

Objeto

{
  "id": "a1b2c3d4-…",
  "legalName": "Gestora Costa SL",
  "nif": "B12345678",
  "fiscalAddress": "Calle Mayor 1, Tarifa",
  "createdAt": "2026-07-01T09:00:00.000Z",
  "updatedAt": "2026-07-19T10:00:00.000Z"
}

Un propietario se crea una vez y se asigna a una o varias propiedades por su id (campo ownerId en /properties). Editar el propietario aquí actualiza los datos en todas sus propiedades a la vez.

Crear un propietario

POST/owners

Body

Campo	Tipo	Descripción
`legalName`requerido	string	Nombre o razón social del arrendador.
`nif`	string	NIF/CIF.
`fiscalAddress`	string	Domicilio fiscal.

curl

curl -X POST https://api.kinapi.es/api/v1/owners \
  -H "ocp-apim-subscription-key: TU_API_KEY" \
  -H "content-type: application/json" \
  -d '{ "legalName": "Gestora Costa SL", "nif": "B12345678" }'

Listar propietarios

GET/owners

curl

curl https://api.kinapi.es/api/v1/owners \
  -H "ocp-apim-subscription-key: TU_API_KEY"

Consultar un propietario

GET/owners/{id}

Actualizar un propietario

PATCH/owners/{id}

Actualización parcial. El cambio se refleja en todas las propiedades que lo tengan asignado.

Eliminar un propietario

DELETE/owners/{id}

Se rechaza con 409 si el propietario aún está asignado a alguna propiedad. Reasigna esas propiedades a otro propietario (con ownerId en PATCH /properties/{id}) antes de eliminarlo.

Las reservas y los registros de un propietario

Cada propiedad lleva su ownerId, también en el listado de GET /properties. Para trabajar con todo lo de un propietario sin saber de antemano cuáles son sus viviendas:

GET /checkins?ownerId=… lista las reservas de todas sus propiedades, también las desactivadas y las que llegaron con un id de canal (ver Check-ins).
POST /exports con ownerId genera un ZIP con sus partes, justificantes de comunicación, contratos y evidencias de firma, para entregárselo.

Cuando dejas de gestionarlo, el panel tiene un asistente para darle de baja: cancelar sus reservas futuras, exportar sus registros, desactivar sus viviendas y suprimir sus datos. Todo está en Exportación y fin del servicio.