GET/v2/devicesFind devices (v2)

Find devices in EffectiveDevice format
parameteroffsetPage offset (default: 0): Number
parametersizeNumber of items on Page (default: 50, max: 100): Number
parameterdeviceIdDevice id search for a specific device: Number
parameterorganizationIdThe organization from which the devices will be taken: Number
parameterorganizationNameThe organization from which the devices will be taken: String
parameterdeviceGroupIdThe group from which the devices will be taken: Number
parametersearchWildcard searching for name, location and remarks and Id: String
parameternameGet a device using a search for name.: String
parameterlocationGet a device using a search for location.: String
parameterremarksGet a device using a search for remarks.: String
parameterdeviceTypeGet a device matching one of the following types: Lock, Keyfob, Gateway: String
parameterincludeGroupsThe connected groups will be returned directly: Boolean
parameterincludeReachableGatewaysThe gateways which are in range of the devices: Boolean
parameterincludeReachableDevicesThe devices which are in range of the gateways: Boolean
parameterincludeDecommissionedDevices who are not available: Boolean
parameterincludeUninstalledDevices who are not installed: Boolean
parametersortBySort by: name, batteryLevel: String
parametersortDirectionSort direction: asc, desc: "Asc" / "Desc"
parameterfilterInstalled,Uninstalled,Decommissioned,Commissioned: [String]
headerAuthorizationAuthentication token (bearer token or API key).

Response

status200All ok
status401Invalid authentication token
status403Insufficient rights
[{
"id" : Number,
"name" : String,
"owner" : {
"organizationId" : Number,
"accountId" : Number,
"name" : String,
"firstName" : String,
"lastName" : String
},
"model" : {
"id" : Number,
"name" : String,
"type" : {
"id" : Number,
"name" : String,
"description" : String
},
"description" : String
},
"settings" : {
"activationTime" : Number,
"soundVolume" : Number,
"pressButtonActivation" : Boolean,
"controllerFunctionality" : Boolean,
"backupPinsConfigured" : Boolean,
"acknowledged" : Boolean,
"dateCreated" : Date/time with a timezone (ISO 8601, e.g. "2022-06-23T13:53:02+02:00"),
"dateModified" : Date/time with a timezone (ISO 8601, e.g. "2022-06-23T13:53:02+02:00"),
"backupPin1Name" : String,
"backupPin2Name" : String,
"backupPin3Name" : String,
"dateLastExternalSync" : Date/time with a timezone (ISO 8601, e.g. "2022-06-23T13:53:02+02:00"),
"relayNormallyOpen" : Boolean,
"vibrationTamperDetection" : Boolean,
"vibrationTamperSensitivity" : Number,
"rotationsTamperDetection" : Boolean,
"buttonActivationTime" : Number,
"pressButtonDeactivation" : Boolean,
"rangeBoost" : Number,
"powerSaveMode" : Boolean,
"turnToBoost" : Boolean,
"lockedStatus" : Boolean,
"turnToActivate" : Boolean,
"tailgaterProtection" : Boolean,
"buttonAutoDisable" : Boolean,
"suppressDeviceEvents" : Boolean,
"unlockDirection" : "AUTO" / "CLOCKWISE" / "COUNTER_CLOCKWISE",
"boldProtocol" : Boolean,
"matterProtocol" : Boolean,
"faultyPinTamperDetection" : Number,
"walkInMode" : Number
},
"features" : {
"activatable" : Boolean,
"rangeBoostMode" : Boolean,
"remoteAccess" : Boolean,
"backupPins" : Boolean,
"shareAccess" : Boolean,
"eventLog" : Boolean,
"turnToActivate" : Boolean,
"tailgaterProtection" : Boolean,
"matter" : Boolean,
"turnToBoost" : Boolean,
"lockedStatus" : Boolean,
"buttonAutoDisable" : Boolean,
"powerSaveMode" : Boolean,
"nightLock" : Boolean,
"leaveAlert" : Boolean,
"tamperDetection" : Boolean,
"webKeys" : Boolean,
"dynamicPins" : Boolean,
"extendedEventLog" : Boolean,
"keepActiveMode" : Boolean,
"showRealUser" : Boolean,
"walkInMode" : Boolean,
"controller" : Boolean
},
"gateway" : {
"id" : Number,
"rssi" : Number,
"rssiLevel" : "Excellent" / "High" / "Medium" / "Low" / "Critical",
"lastSeen" : Date/time with a timezone (ISO 8601, e.g. "2022-06-23T13:53:02+02:00"),
"name" : String
},
"entryTags" : [String],
"actualFirmwareVersion" : Number,
"requiredFirmwareVersion" : Number,
"dateCreated" : Date/time with a timezone (ISO 8601, e.g. "2022-06-23T13:53:02+02:00"),
"dateModified" : Date/time with a timezone (ISO 8601, e.g. "2022-06-23T13:53:02+02:00"),
"timeZone" : Timezone (TZDB 2005r, e.g. "UTC"),
"batteryLevel" : String,
"batteryLastMeasurement" : Date/time with a timezone (ISO 8601, e.g. "2022-06-23T13:53:02+02:00"),
"isActiveUntil" : Date/time with a timezone (ISO 8601, e.g. "2022-06-23T13:53:02+02:00"),
"carouselImageUrl" : String,
"remarks" : String,
"location" : String,
"locked" : "LOCKED" / "UNLOCKED" / "UNKNOWN",
"lastLocked" : Date/time with a timezone (ISO 8601, e.g. "2022-06-23T13:53:02+02:00"),
"matter" : {
"manuallyProvisioned" : Boolean,
"factoryProvisioned" : Boolean
}
}]

Example: Get all devices as an Account

GET/v2/devices

headerAuthorizationBearer f4d1a4bd-707c-4e3b-8d6a-9b5bbafe81f1

Response

status200
headerAccess-Control-Expose-Headersauthorization, content-type
headerAccess-Control-Allow-Headersauthorization, content-type
headerAccess-Control-Allow-MethodsGET, POST, DELETE, OPTIONS, PUT
headerAccess-Control-Allow-Origin*
headerStrict-Transport-Securitymax-age=31536000; includeSubDomains
headerX-Frame-OptionsSAMEORIGIN
headerX-Content-Type-Optionsnosniff
headerX-XSS-Protection1; mode=block
headerContent-Security-Policydefault-src 'none'; frame-ancestors 'none'; base-uri 'none'; form-action 'none'
headerReferrer-Policyno-referrer
headerFeature-Policyself
headerPermissions-policyinterest-cohort=()
[{
"id": 188,
"name": "Lock1",
"owner": {
"organizationId": 93,
"accountId": 127,
"name": ""
}
,
"model": {
"id": 1,
"name": "SX33",
"type": {
"id": 1,
"name": "Lock",
"description": "Lock"
}
,
"description": "Smart Cylinder SX"
}
,
"settings": {
"activationTime": 5,
"soundVolume": 10,
"pressButtonActivation": true,
"controllerFunctionality": false,
"backupPinsConfigured": false,
"acknowledged": true,
"relayNormallyOpen": true,
"vibrationTamperDetection": false,
"vibrationTamperSensitivity": 50,
"rotationsTamperDetection": false,
"buttonActivationTime": 0,
"pressButtonDeactivation": false,
"rangeBoost": 0,
"powerSaveMode": false,
"turnToBoost": false,
"lockedStatus": false,
"turnToActivate": false,
"tailgaterProtection": false,
"buttonAutoDisable": false,
"suppressDeviceEvents": false,
"unlockDirection": "AUTO",
"boldProtocol": true,
"matterProtocol": false,
"faultyPinTamperDetection": 0,
"walkInMode": 0
}
,
"features": {
"activatable": true,
"rangeBoostMode": false,
"remoteAccess": false,
"backupPins": false,
"shareAccess": false,
"eventLog": false,
"turnToActivate": false,
"tailgaterProtection": false,
"matter": false,
"turnToBoost": false,
"lockedStatus": false,
"buttonAutoDisable": false,
"powerSaveMode": false,
"nightLock": false,
"leaveAlert": false,
"tamperDetection": false,
"webKeys": false,
"dynamicPins": false,
"extendedEventLog": false,
"keepActiveMode": false,
"showRealUser": false,
"walkInMode": false,
"controller": false
}
,
"entryTags": [],
"actualFirmwareVersion": 0,
"requiredFirmwareVersion": 95,
"dateCreated": "2026-03-10T09:42:51.995358Z",
"dateModified": "2026-03-10T09:42:51.996623Z",
"timeZone": "UTC",
"locked": "UNKNOWN",
"matter": {
"manuallyProvisioned": false,
"factoryProvisioned": false
}
}
, {
"id": 189,
"name": "Lock2",
"owner": {
"organizationId": 93,
"accountId": 127,
"name": ""
}
,
"model": {
"id": 1,
"name": "SX33",
"type": {
"id": 1,
"name": "Lock",
"description": "Lock"
}
,
"description": "Smart Cylinder SX"
}
,
"settings": {
"activationTime": 5,
"soundVolume": 10,
"pressButtonActivation": true,
"controllerFunctionality": false,
"backupPinsConfigured": false,
"acknowledged": true,
"relayNormallyOpen": true,
"vibrationTamperDetection": false,
"vibrationTamperSensitivity": 50,
"rotationsTamperDetection": false,
"buttonActivationTime": 0,
"pressButtonDeactivation": false,
"rangeBoost": 0,
"powerSaveMode": false,
"turnToBoost": false,
"lockedStatus": false,
"turnToActivate": false,
"tailgaterProtection": false,
"buttonAutoDisable": false,
"suppressDeviceEvents": false,
"unlockDirection": "AUTO",
"boldProtocol": true,
"matterProtocol": false,
"faultyPinTamperDetection": 0,
"walkInMode": 0
}
,
"features": {
"activatable": true,
"rangeBoostMode": false,
"remoteAccess": false,
"backupPins": false,
"shareAccess": false,
"eventLog": false,
"turnToActivate": false,
"tailgaterProtection": false,
"matter": false,
"turnToBoost": false,
"lockedStatus": false,
"buttonAutoDisable": false,
"powerSaveMode": false,
"nightLock": false,
"leaveAlert": false,
"tamperDetection": false,
"webKeys": false,
"dynamicPins": false,
"extendedEventLog": false,
"keepActiveMode": false,
"showRealUser": false,
"walkInMode": false,
"controller": false
}
,
"entryTags": [],
"actualFirmwareVersion": 0,
"requiredFirmwareVersion": 0,
"dateCreated": "2026-03-10T09:42:51.99606Z",
"timeZone": "UTC",
"locked": "UNKNOWN",
"matter": {
"manuallyProvisioned": false,
"factoryProvisioned": false
}
}
]

Example: Get all devices as a System Admin

GET/v2/devices

headerAuthorizationBearer a4d32cdf-534e-4a01-bb6b-c9c1638c21d2

Response

status200
headerAccess-Control-Expose-Headersauthorization, content-type
headerAccess-Control-Allow-Headersauthorization, content-type
headerAccess-Control-Allow-MethodsGET, POST, DELETE, OPTIONS, PUT
headerAccess-Control-Allow-Origin*
headerStrict-Transport-Securitymax-age=31536000; includeSubDomains
headerX-Frame-OptionsSAMEORIGIN
headerX-Content-Type-Optionsnosniff
headerX-XSS-Protection1; mode=block
headerContent-Security-Policydefault-src 'none'; frame-ancestors 'none'; base-uri 'none'; form-action 'none'
headerReferrer-Policyno-referrer
headerFeature-Policyself
headerPermissions-policyinterest-cohort=()
[{
"id": 192,
"name": "Lock1",
"owner": {
"organizationId": 95,
"accountId": 130,
"name": ""
}
,
"model": {
"id": 1,
"name": "SX33",
"type": {
"id": 1,
"name": "Lock",
"description": "Lock"
}
,
"description": "Smart Cylinder SX"
}
,
"settings": {
"activationTime": 5,
"soundVolume": 10,
"pressButtonActivation": true,
"controllerFunctionality": false,
"backupPinsConfigured": false,
"acknowledged": true,
"relayNormallyOpen": true,
"vibrationTamperDetection": false,
"vibrationTamperSensitivity": 50,
"rotationsTamperDetection": false,
"buttonActivationTime": 0,
"pressButtonDeactivation": false,
"rangeBoost": 0,
"powerSaveMode": false,
"turnToBoost": false,
"lockedStatus": false,
"turnToActivate": false,
"tailgaterProtection": false,
"buttonAutoDisable": false,
"suppressDeviceEvents": false,
"unlockDirection": "AUTO",
"boldProtocol": true,
"matterProtocol": false,
"faultyPinTamperDetection": 0,
"walkInMode": 0
}
,
"features": {
"activatable": true,
"rangeBoostMode": false,
"remoteAccess": false,
"backupPins": false,
"shareAccess": false,
"eventLog": false,
"turnToActivate": false,
"tailgaterProtection": false,
"matter": false,
"turnToBoost": false,
"lockedStatus": false,
"buttonAutoDisable": false,
"powerSaveMode": false,
"nightLock": false,
"leaveAlert": false,
"tamperDetection": false,
"webKeys": false,
"dynamicPins": false,
"extendedEventLog": false,
"keepActiveMode": false,
"showRealUser": false,
"walkInMode": false,
"controller": false
}
,
"entryTags": [],
"actualFirmwareVersion": 0,
"requiredFirmwareVersion": 95,
"dateCreated": "2026-03-10T09:42:53.010183Z",
"dateModified": "2026-03-10T09:42:53.011296Z",
"timeZone": "UTC",
"locked": "UNKNOWN",
"matter": {
"manuallyProvisioned": false,
"factoryProvisioned": false
}
}
, {
"id": 194,
"name": "Lock1",
"owner": {
"organizationId": 96,
"name": ""
}
,
"model": {
"id": 1,
"name": "SX33",
"type": {
"id": 1,
"name": "Lock",
"description": "Lock"
}
,
"description": "Smart Cylinder SX"
}
,
"settings": {
"activationTime": 5,
"soundVolume": 10,
"pressButtonActivation": true,
"controllerFunctionality": false,
"backupPinsConfigured": false,
"acknowledged": true,
"relayNormallyOpen": true,
"vibrationTamperDetection": false,
"vibrationTamperSensitivity": 50,
"rotationsTamperDetection": false,
"buttonActivationTime": 0,
"pressButtonDeactivation": false,
"rangeBoost": 0,
"powerSaveMode": false,
"turnToBoost": false,
"lockedStatus": false,
"turnToActivate": false,
"tailgaterProtection": false,
"buttonAutoDisable": false,
"suppressDeviceEvents": false,
"unlockDirection": "AUTO",
"boldProtocol": true,
"matterProtocol": false,
"faultyPinTamperDetection": 0,
"walkInMode": 0
}
,
"features": {
"activatable": true,
"rangeBoostMode": false,
"remoteAccess": false,
"backupPins": false,
"shareAccess": false,
"eventLog": false,
"turnToActivate": false,
"tailgaterProtection": false,
"matter": false,
"turnToBoost": false,
"lockedStatus": false,
"buttonAutoDisable": false,
"powerSaveMode": false,
"nightLock": false,
"leaveAlert": false,
"tamperDetection": false,
"webKeys": false,
"dynamicPins": false,
"extendedEventLog": false,
"keepActiveMode": false,
"showRealUser": false,
"walkInMode": false,
"controller": false
}
,
"entryTags": [],
"actualFirmwareVersion": 95,
"requiredFirmwareVersion": 0,
"dateCreated": "2026-03-10T09:42:53.016237Z",
"dateModified": "2026-03-10T09:42:53.017236Z",
"timeZone": "UTC",
"locked": "UNKNOWN",
"matter": {
"manuallyProvisioned": false,
"factoryProvisioned": false
}
}
, {
"id": 193,
"name": "Lock2",
"owner": {
"organizationId": 95,
"accountId": 130,
"name": ""
}
,
"model": {
"id": 1,
"name": "SX33",
"type": {
"id": 1,
"name": "Lock",
"description": "Lock"
}
,
"description": "Smart Cylinder SX"
}
,
"settings": {
"activationTime": 5,
"soundVolume": 10,
"pressButtonActivation": true,
"controllerFunctionality": false,
"backupPinsConfigured": false,
"acknowledged": true,
"relayNormallyOpen": true,
"vibrationTamperDetection": false,
"vibrationTamperSensitivity": 50,
"rotationsTamperDetection": false,
"buttonActivationTime": 0,
"pressButtonDeactivation": false,
"rangeBoost": 0,
"powerSaveMode": false,
"turnToBoost": false,
"lockedStatus": false,
"turnToActivate": false,
"tailgaterProtection": false,
"buttonAutoDisable": false,
"suppressDeviceEvents": false,
"unlockDirection": "AUTO",
"boldProtocol": true,
"matterProtocol": false,
"faultyPinTamperDetection": 0,
"walkInMode": 0
}
,
"features": {
"activatable": true,
"rangeBoostMode": false,
"remoteAccess": false,
"backupPins": false,
"shareAccess": false,
"eventLog": false,
"turnToActivate": false,
"tailgaterProtection": false,
"matter": false,
"turnToBoost": false,
"lockedStatus": false,
"buttonAutoDisable": false,
"powerSaveMode": false,
"nightLock": false,
"leaveAlert": false,
"tamperDetection": false,
"webKeys": false,
"dynamicPins": false,
"extendedEventLog": false,
"keepActiveMode": false,
"showRealUser": false,
"walkInMode": false,
"controller": false
}
,
"entryTags": [],
"actualFirmwareVersion": 0,
"requiredFirmwareVersion": 0,
"dateCreated": "2026-03-10T09:42:53.010785Z",
"timeZone": "UTC",
"locked": "UNKNOWN",
"matter": {
"manuallyProvisioned": false,
"factoryProvisioned": false
}
}
, {
"id": 195,
"name": "Lock2",
"owner": {
"organizationId": 96,
"name": ""
}
,
"model": {
"id": 1,
"name": "SX33",
"type": {
"id": 1,
"name": "Lock",
"description": "Lock"
}
,
"description": "Smart Cylinder SX"
}
,
"settings": {
"activationTime": 5,
"soundVolume": 10,
"pressButtonActivation": true,
"controllerFunctionality": false,
"backupPinsConfigured": false,
"acknowledged": true,
"relayNormallyOpen": true,
"vibrationTamperDetection": false,
"vibrationTamperSensitivity": 50,
"rotationsTamperDetection": false,
"buttonActivationTime": 0,
"pressButtonDeactivation": false,
"rangeBoost": 0,
"powerSaveMode": false,
"turnToBoost": false,
"lockedStatus": false,
"turnToActivate": false,
"tailgaterProtection": false,
"buttonAutoDisable": false,
"suppressDeviceEvents": false,
"unlockDirection": "AUTO",
"boldProtocol": true,
"matterProtocol": false,
"faultyPinTamperDetection": 0,
"walkInMode": 0
}
,
"features": {
"activatable": true,
"rangeBoostMode": false,
"remoteAccess": false,
"backupPins": false,
"shareAccess": false,
"eventLog": false,
"turnToActivate": false,
"tailgaterProtection": false,
"matter": false,
"turnToBoost": false,
"lockedStatus": false,
"buttonAutoDisable": false,
"powerSaveMode": false,
"nightLock": false,
"leaveAlert": false,
"tamperDetection": false,
"webKeys": false,
"dynamicPins": false,
"extendedEventLog": false,
"keepActiveMode": false,
"showRealUser": false,
"walkInMode": false,
"controller": false
}
,
"entryTags": [],
"actualFirmwareVersion": 0,
"requiredFirmwareVersion": 0,
"dateCreated": "2026-03-10T09:42:53.016749Z",
"timeZone": "UTC",
"locked": "UNKNOWN",
"matter": {
"manuallyProvisioned": false,
"factoryProvisioned": false
}
}
]

Example: Get devices filtered by deviceId

GET/v2/devices

parameterdeviceId196
headerAuthorizationBearer 633ed098-866b-4097-9000-c2357abae5b5

Response

status200
headerAccess-Control-Expose-Headersauthorization, content-type
headerAccess-Control-Allow-Headersauthorization, content-type
headerAccess-Control-Allow-MethodsGET, POST, DELETE, OPTIONS, PUT
headerAccess-Control-Allow-Origin*
headerStrict-Transport-Securitymax-age=31536000; includeSubDomains
headerX-Frame-OptionsSAMEORIGIN
headerX-Content-Type-Optionsnosniff
headerX-XSS-Protection1; mode=block
headerContent-Security-Policydefault-src 'none'; frame-ancestors 'none'; base-uri 'none'; form-action 'none'
headerReferrer-Policyno-referrer
headerFeature-Policyself
headerPermissions-policyinterest-cohort=()
[{
"id": 196,
"name": "Lock1",
"owner": {
"organizationId": 97,
"accountId": 133,
"name": ""
}
,
"model": {
"id": 1,
"name": "SX33",
"type": {
"id": 1,
"name": "Lock",
"description": "Lock"
}
,
"description": "Smart Cylinder SX"
}
,
"settings": {
"activationTime": 5,
"soundVolume": 10,
"pressButtonActivation": true,
"controllerFunctionality": false,
"backupPinsConfigured": false,
"acknowledged": true,
"relayNormallyOpen": true,
"vibrationTamperDetection": false,
"vibrationTamperSensitivity": 50,
"rotationsTamperDetection": false,
"buttonActivationTime": 0,
"pressButtonDeactivation": false,
"rangeBoost": 0,
"powerSaveMode": false,
"turnToBoost": false,
"lockedStatus": false,
"turnToActivate": false,
"tailgaterProtection": false,
"buttonAutoDisable": false,
"suppressDeviceEvents": false,
"unlockDirection": "AUTO",
"boldProtocol": true,
"matterProtocol": false,
"faultyPinTamperDetection": 0,
"walkInMode": 0
}
,
"features": {
"activatable": true,
"rangeBoostMode": false,
"remoteAccess": false,
"backupPins": false,
"shareAccess": false,
"eventLog": false,
"turnToActivate": false,
"tailgaterProtection": false,
"matter": false,
"turnToBoost": false,
"lockedStatus": false,
"buttonAutoDisable": false,
"powerSaveMode": false,
"nightLock": false,
"leaveAlert": false,
"tamperDetection": false,
"webKeys": false,
"dynamicPins": false,
"extendedEventLog": false,
"keepActiveMode": false,
"showRealUser": false,
"walkInMode": false,
"controller": false
}
,
"entryTags": [],
"actualFirmwareVersion": 0,
"requiredFirmwareVersion": 95,
"dateCreated": "2026-03-10T09:42:53.962402Z",
"dateModified": "2026-03-10T09:42:53.96333Z",
"timeZone": "UTC",
"locked": "UNKNOWN",
"matter": {
"manuallyProvisioned": false,
"factoryProvisioned": false
}
}
]