Lock Pro Matter Enabled

May 16, 2026 ยท View on GitHub


Device List Information

KeyValue TypeDescription
deviceIdStringdevice ID
deviceNameStringdevice name
deviceTypeStringdevice type. Smart Lock Pro Wifi
enableCloudServiceBooleandetermines if Cloud Service is enabled or not for the current device
hubDeviceIdStringdevice's parent Hub ID

Device status example (GET /v1.1/devices/{deviceId}/status),

{
  "deviceId": "FFFFFFFFFFF",
  "deviceType": "Smart Lock Pro Wifi",
  "hubDeviceId": "FFFFFFFFFFF",
  "battery": 100,
  "version": "V6.3",
  "lockState": "unlock",
  "doorState": "open",
  "calibrate": true
}

lockState can be jammed, unlock, lock, latchBoltLocked. doorState can be open or close.


Device Status

KeyValue TypeDescription
deviceIdStringdevice ID
deviceTypeStringdevice type. Smart Lock Pro Wifi
hubDeviceIdStringdevice's parent Hub ID
batteryIntegerthe current battery level, 0-100
versionStringthe current firmware version, e.g. V6.3
lockStateStringjammed, unlock, lock, latchBoltLocked
doorStateStringopen, close
calibrateBooleandetermines if Lock has been calibrated or not
onlineStatusStringthe connection status of the device. online or offline

Control Commands

deviceTypecommandTypeCommandcommand parameterDescription
Smart Lock Pro Wificommandlockdefaultrotate to locked position
Smart Lock Pro Wificommandunlockdefaultrotate to unlocked position
Smart Lock Pro WificommandnightLatchUnlockdefaultunlock night latch (EU)
Smart Lock Pro Wificommanddeadboltdefaultdisengage deadbolt or latch

Webhook Events

Key NameValue TypeDescription
eventTypeStringthe type of events
eventVersionStringthe current event version
contextObjectthe detail info of the event
deviceTypeStringthe type of the device
deviceMacStringthe MAC address of the device
lockStateStringthe state of the device, "LOCKED" stands for the motor is rotated to locking position; "UNLOCKED" stands for the motor is rotated to unlocking position; "JAMMED" stands for the motor is jammed while rotating
batteryIntegerthe current battery level, 0-100
timeOfSampleLongthe time stamp when the event is sent
{
    "eventType": "changeReport",
    "eventVersion": "1",
    "context": {
        "deviceType": "WoLockProWifi",
        "deviceMac": DEVICE_MAC_ADDR,
        "lockState": "LOCKED",
        "battery": 90,
        "timeOfSample": 123456789
    }
}