Lock Lite

May 16, 2026 ยท View on GitHub


Device List Information

KeyValue TypeDescription
deviceIdStringdevice ID
deviceNameStringdevice name
deviceTypeStringdevice type. Lock Lite
enableCloudServiceBooleandetermines if Cloud Service is enabled or not for the current device
hubDeviceIdStringdevice's parent Hub ID
groupBooleandetermines if a Lock is grouped with another Lock or not
masterBooleandetermines if a Lock is the master device or not when grouped with another Lock in Dual Lock mode
groupNameStringthe name of the Lock group
lockDevicesIdsArraya list of Lock device IDs such that the Lock devices are being grouped in Dual Lock mode

Device Status

KeyValue TypeDescription
deviceIdStringdevice ID
deviceTypeStringdevice type. Lock Lite
hubDeviceIdStringdevice's parent Hub ID
batteryIntegerthe current battery level
versionStringthe current BLE and Wi-Fi firmware version, e.g. V3.1-6.3
lockStateStringdetermines if locked or not, jammed, unlock or lock
calibrateBooleandetermines if the open and the closed positions have been properly calibrated or not

Control Commands

deviceTypecommandTypeCommandcommand parameterDescription
Lock Litecommandlockdefaultrotate to locked position
Lock Litecommandunlockdefaultrotate to unlocked position

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
lockStateStringdetermines if locked or not
batteryIntegerthe battery level
timeOfSampleLongthe time stamp when the event is sent
{
    "eventType": "changeReport",
    "eventVersion": "1",
    "context": {
        "deviceType": "WoLockLite",
        "deviceMac": DEVICE_MAC_ADDR,
        "lockState": "LOCKED",
        "battery": 90,
        "timeOfSample": 123456789
    }
}