SmartLocks

List smart locks for a property with live status

GET

/properties/{id}/smartlocks

Returns every smart lock assigned to the property together with its current lock/battery status fetched from the underlying provider (Nuki or Unifi).

List smart locks for a property with live status › path Parameters

id

string · required

Property id

List smart locks for a property with live status › Responses

Smart locks with their live status

SmartLock[]

SmartLock

id

string · uuid · required

vendor

string · required

name

string · required

property_id

string · uuid · required

lock_state

integer | null

battery_level

integer | null

battery_charging

boolean | null

offline

boolean

GET/properties/{id}/smartlocks

curl --request GET \
  --url /properties/:id/smartlocks

shell

Example Responses

[
  {
    "id": "00000000-0000-0000-0000-000000000000",
    "vendor": "vendor",
    "name": "name",
    "property_id": "00000000-0000-0000-0000-000000000000",
    "nuki_smartlock": {
      "id": "00000000-0000-0000-0000-000000000000",
      "nuki_smartlock_id": "nuki_smartlock_id"
    },
    "unifi_smartlock": {
      "floor_id": "floor_id",
      "door_id": "door_id",
      "name": "name",
      "assigned_property": {
        "property_id": "00000000-0000-0000-0000-000000000000",
        "property_name": "property_name",
        "smartlock_record_id": "00000000-0000-0000-0000-000000000000"
      }
    },
    "lock_state": 0,
    "battery_level": 0,
    "battery_charging": true,
    "offline": true
  }
]

json

application/json

Add a smart lock to a property

POST

/properties/{id}/smartlocks

Attaches either a Nuki smart lock (requires nuki_smartlock_id and nuki_integration_id) or a Unifi smart lock (requires unifi_floor_id and unifi_door_id) to the property.

Add a smart lock to a property › path Parameters

id

string · required

Property id

Add a smart lock to a property › Request Body

AddSmartlockRequest

name

string · required

nuki_smartlock_id

string | null

nuki_integration_id

string | null · uuid

unifi_floor_id

string | null

unifi_door_id

string | null

Add a smart lock to a property › Responses

The created smart lock

SmartLock

id

string · uuid · required

vendor

string · required

name

string · required

property_id

string · uuid · required

lock_state

integer | null

battery_level

integer | null

battery_charging

boolean | null

offline

boolean

POST/properties/{id}/smartlocks

curl --request POST \
  --url /properties/:id/smartlocks \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "name",
  "nuki_smartlock_id": "nuki_smartlock_id",
  "nuki_integration_id": "00000000-0000-0000-0000-000000000000",
  "unifi_floor_id": "unifi_floor_id",
  "unifi_door_id": "unifi_door_id"
}
'

shell

Example Request Body

{
  "name": "name",
  "nuki_smartlock_id": "nuki_smartlock_id",
  "nuki_integration_id": "00000000-0000-0000-0000-000000000000",
  "unifi_floor_id": "unifi_floor_id",
  "unifi_door_id": "unifi_door_id"
}

json

Example Responses

{
  "id": "00000000-0000-0000-0000-000000000000",
  "vendor": "vendor",
  "name": "name",
  "property_id": "00000000-0000-0000-0000-000000000000",
  "nuki_smartlock": {
    "id": "00000000-0000-0000-0000-000000000000",
    "nuki_smartlock_id": "nuki_smartlock_id"
  },
  "unifi_smartlock": {
    "floor_id": "floor_id",
    "door_id": "door_id",
    "name": "name",
    "assigned_property": {
      "property_id": "00000000-0000-0000-0000-000000000000",
      "property_name": "property_name",
      "smartlock_record_id": "00000000-0000-0000-0000-000000000000"
    }
  },
  "lock_state": 0,
  "battery_level": 0,
  "battery_charging": true,
  "offline": true
}

json

application/json

Remove a smart lock from a property

DELETE

/properties/{id}/smartlocks/{smartlockId}

Remove a smart lock from a property › path Parameters

id

string · required

Property id

smartlockId

string · required

Smart lock id

Remove a smart lock from a property › Responses

Smart lock removed

No data returned

PropertyMembers Tasks

Kasify API

SmartLocks

List smart locks for a property with live status

GET

/properties/{id}/smartlocks

Returns every smart lock assigned to the property together with its current lock/battery status fetched from the underlying provider (Nuki or Unifi).

List smart locks for a property with live status › path Parameters

id

string · required

Property id

List smart locks for a property with live status › Responses

Smart locks with their live status

SmartLock[]

SmartLock

id

string · uuid · required

vendor

string · required

name

string · required

property_id

string · uuid · required

lock_state

integer | null

battery_level

integer | null

battery_charging

boolean | null

offline

boolean

GET/properties/{id}/smartlocks

curl --request GET \
  --url /properties/:id/smartlocks

shell

Example Responses

[
  {
    "id": "00000000-0000-0000-0000-000000000000",
    "vendor": "vendor",
    "name": "name",
    "property_id": "00000000-0000-0000-0000-000000000000",
    "nuki_smartlock": {
      "id": "00000000-0000-0000-0000-000000000000",
      "nuki_smartlock_id": "nuki_smartlock_id"
    },
    "unifi_smartlock": {
      "floor_id": "floor_id",
      "door_id": "door_id",
      "name": "name",
      "assigned_property": {
        "property_id": "00000000-0000-0000-0000-000000000000",
        "property_name": "property_name",
        "smartlock_record_id": "00000000-0000-0000-0000-000000000000"
      }
    },
    "lock_state": 0,
    "battery_level": 0,
    "battery_charging": true,
    "offline": true
  }
]

json

application/json

Add a smart lock to a property

POST

/properties/{id}/smartlocks

Attaches either a Nuki smart lock (requires nuki_smartlock_id and nuki_integration_id) or a Unifi smart lock (requires unifi_floor_id and unifi_door_id) to the property.

Add a smart lock to a property › path Parameters

id

string · required

Property id

Add a smart lock to a property › Request Body

AddSmartlockRequest

name

string · required

nuki_smartlock_id

string | null

nuki_integration_id

string | null · uuid

unifi_floor_id

string | null

unifi_door_id

string | null

Add a smart lock to a property › Responses

The created smart lock

SmartLock

id

string · uuid · required

vendor

string · required

name

string · required

property_id

string · uuid · required

lock_state

integer | null

battery_level

integer | null

battery_charging

boolean | null

offline

boolean

POST/properties/{id}/smartlocks

curl --request POST \
  --url /properties/:id/smartlocks \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "name",
  "nuki_smartlock_id": "nuki_smartlock_id",
  "nuki_integration_id": "00000000-0000-0000-0000-000000000000",
  "unifi_floor_id": "unifi_floor_id",
  "unifi_door_id": "unifi_door_id"
}
'

shell

Example Request Body

{
  "name": "name",
  "nuki_smartlock_id": "nuki_smartlock_id",
  "nuki_integration_id": "00000000-0000-0000-0000-000000000000",
  "unifi_floor_id": "unifi_floor_id",
  "unifi_door_id": "unifi_door_id"
}

json

Example Responses

{
  "id": "00000000-0000-0000-0000-000000000000",
  "vendor": "vendor",
  "name": "name",
  "property_id": "00000000-0000-0000-0000-000000000000",
  "nuki_smartlock": {
    "id": "00000000-0000-0000-0000-000000000000",
    "nuki_smartlock_id": "nuki_smartlock_id"
  },
  "unifi_smartlock": {
    "floor_id": "floor_id",
    "door_id": "door_id",
    "name": "name",
    "assigned_property": {
      "property_id": "00000000-0000-0000-0000-000000000000",
      "property_name": "property_name",
      "smartlock_record_id": "00000000-0000-0000-0000-000000000000"
    }
  },
  "lock_state": 0,
  "battery_level": 0,
  "battery_charging": true,
  "offline": true
}

json

application/json

Remove a smart lock from a property

DELETE

/properties/{id}/smartlocks/{smartlockId}

Remove a smart lock from a property › path Parameters

id

string · required

Property id

smartlockId

string · required

Smart lock id

Remove a smart lock from a property › Responses

Smart lock removed

No data returned

PropertyMembers Tasks