Error Codes

The API will return error codes in webhook responses when an issue occurred while executing your API request.

Here is an example of a webhook response for a request that failed. Note that the request will include a generic status that the operation included a failure, plus information regarding the single or multiple entities which failed.

{
    "detail": [
        {
            "smartlockId": 123456789,
            "success": false,
            "errorCode": "ff",
            "id": "68b142..........a584f104"
        }
    ],
    "type": "AuthCreation",
    "requestId": "68b142..........a584f103",
    "success": false
}

Error Codes

Error Code	Description	Recommended Remediation
0xFD	ERROR_BAD_CRC
0xFE	ERROR_BAD_LENGTH
0xFF	ERROR_UNKNOWN	Device is most likely offline or not reachable Implement a retry mechanism Check if the smart lock is in an optimised network (1, 2)
0x10	P_ERROR_NOT_PAIRING
0x11	P_ERROR_BAD_AUTHENTICATOR
0x12	P_ERROR_BAD_PARAMETER
0x13	P_ERROR_MAX_USER	The limit of 200 device authorisations has been reached. Delete unused authorisations
0x20	K_ERROR_NOT_AUTHORIZED
0x21	K_ERROR_BAD_PIN
0x22	K_ERROR_BAD_NONCE
0x23	K_ERROR_BAD_PARAMETER
0x24	K_ERROR_INVALID_AUTH_ID
0x25	K_ERROR_DISABLED
0x26	K_ERROR_REMOTE_NOT_ALLOWED
0x27	K_ERROR_TIME_NOT_ALLOWED
0x28	K_ERROR_TOO_MANY_PIN_ATTEMPTS
0x29	K_ERROR_TOO_MANY_ENTRIES
0x2A	K_ERROR_CODE_ALREADY_EXISTS
0x2B	K_ERROR_CODE_INVALID
0x2C	K_ERROR_CODE_INVALID_TIMEOUT_1
0x2D	K_ERROR_CODE_INVALID_TIMEOUT_2
0x2E	K_ERROR_CODE_INVALID_TIMEOUT_3
0x40	K_ERROR_AUTO_UNLOCK_TOO_RECENT
0x41	K_ERROR_POSITION_UNKNOWN
0x42	K_ERROR_MOTOR_BLOCKED
0x43	K_ERROR_CLUTCH_FAILURE
0x44	K_ERROR_MOTOR_TIMEOUT
0x45	K_ERROR_BUSY
0x46	K_ERROR_CANCELED
0x47	K_ERROR_NOT_CALIBRATED
0x48	K_ERROR_MOTOR_POSITION_LIMIT
0x49	K_ERROR_MOTOR_LOW_VOLTAGE
0x4A	K_ERROR_MOTOR_POWER_FAILURE
0x4B	K_ERROR_CLUTCH_POWER_FAILURE
0x4C	K_ERROR_VOLTAGE_TOO_LOW
0x4D	K_ERROR_FIRMWARE_UPDATE_NEEDED
0x4E	K_ERROR_REJECTED
0x4F	K_ERROR_REJECTED_NIGHTMODE
0xE0	K_ERROR_NOT_IN_MAINTENANCE_MODE
0xE1	K_ERROR_ALREADY_CONFIGURED
0xE2	K_ERROR_TIMEOUT
0xE3	K_ERROR_NO_NUKI_ID
0x60	K_ERROR_DS_CALIBRATION_FAILED
0x61	K_ERROR_DS_TIMEOUT