GET/v1/devices/{device-id}Get specific device

Get specific device

parameter	includeReachableGateways	The gateways which are in range of the device: Boolean
parameter	includeReachableDevices	The devices which are in range of the gateway: Boolean
header	Authorization	Authentication token (bearer token or API key).

Response

status	200	All ok
status	401	Invalid authentication token
status	403	Insufficient rights
status	404	Device not found
{ "id" : Number, "name" : String, "organizationId" : Number, "organizationName" : String, "deviceModel" : { "id" : Number, "deviceType" : { "id" : Number, "name" : String, "description" : String }, "model" : String, "name" : String }, "actualFirmwareVersion" : Number, "requiredFirmwareVersion" : Number, "timeZone" : Timezone (TZDB 2005r, e.g. "UTC"), "batchKey" : String, UUID 4 formatted (e.g. "a426e157-8a5c-456a-8865-bec6394867ab"), "batteryLevel" : String, "batteryLevelReminder" : Date/time with a timezone (ISO 8601, e.g. "2022-06-23T13:53:02+02:00"), "batteryLastMeasurement" : Date/time with a timezone (ISO 8601, e.g. "2022-06-23T13:53:02+02:00"), "remarks" : String, "location" : String, "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"), "dateAssigned" : Date/time with a timezone (ISO 8601, e.g. "2022-06-23T13:53:02+02:00"), "gatewayId" : Number, "gatewayRssi" : Number, "gatewayRssiLevel" : "Excellent" / "High" / "Medium" / "Low" / "Critical", "gatewayLastSeen" : Date/time with a timezone (ISO 8601, e.g. "2022-06-23T13:53:02+02:00"), "gatewayLastSeenMessage" : Date/time with a timezone (ISO 8601, e.g. "2022-06-23T13:53:02+02:00"), "messageQueueCount" : Number, "sequenceNumberDeviceEvents" : Number, "decommissioned" : Boolean, "restricted" : Boolean, "restrictedReminder" : Date/time with a timezone (ISO 8601, e.g. "2022-06-23T13:53:02+02:00"), "minCommandStart" : Date/time with a timezone (ISO 8601, e.g. "2022-06-23T13:53:02+02:00"), "dateLastExternalSync" : 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, "dateLastKeyExchange" : Date/time with a timezone (ISO 8601, e.g. "2022-06-23T13:53:02+02:00"), "dateLastKnownActivation" : Date/time with a timezone (ISO 8601, e.g. "2022-06-23T13:53:02+02:00"), "lastTimeSyncDate" : Date/time with a timezone (ISO 8601, e.g. "2022-06-23T13:53:02+02:00"), "lastTimeSyncDrift" : Number, "relatedDeviceGroups" : [{ "id" : Number, "organizationId" : Number, "name" : String, "remarks" : String, "location" : String, "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") }], "reachableGateways" : [{ "id" : Number, "deviceId" : Number, "gatewayId" : 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"), "flags" : { "timeSyncNeeded" : Boolean, "installationMode" : Boolean, "eventsAvailable" : 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"), "deviceName" : String, "deviceOrganizationId" : Number, "deviceModel" : { "id" : Number, "deviceType" : { "id" : Number, "name" : String, "description" : String }, "model" : String, "name" : String } }], "reachableDevices" : [{ "id" : Number, "deviceId" : Number, "gatewayId" : 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"), "flags" : { "timeSyncNeeded" : Boolean, "installationMode" : Boolean, "eventsAvailable" : 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"), "deviceName" : String, "deviceOrganizationId" : Number, "deviceModel" : { "id" : Number, "deviceType" : { "id" : Number, "name" : String, "description" : String }, "model" : String, "name" : String } }] }

Example: Get a personal device as an Account

GET/v1/devices/57

header	Authorization	Bearer 188c3994-9060-4491-b260-0fb47d1f31a1

Response

status	200
header	Access-Control-Expose-Headers	authorization, content-type
header	Access-Control-Allow-Headers	authorization, content-type
header	Access-Control-Allow-Methods	GET, POST, DELETE, OPTIONS, PUT
header	Access-Control-Allow-Origin	*
header	Strict-Transport-Security	max-age=31536000; includeSubDomains
header	X-Frame-Options	SAMEORIGIN
header	X-Content-Type-Options	nosniff
header	X-XSS-Protection	1; mode=block
header	Content-Security-Policy	default-src 'none'; frame-ancestors 'none'; base-uri 'none'; form-action 'none'
header	Referrer-Policy	no-referrer
header	Feature-Policy	self
header	Permissions-policy	interest-cohort=()
{ "id": 57, "name": "Lock1", "organizationId": 29, "organizationName": "", "deviceModel": { "id": 1, "deviceType": { "id": 1, "name": "Lock", "description": "Lock" }, "model": "Smart Cylinder SX", "name": "Smart Cylinder SX" }, "actualFirmwareVersion": 0, "requiredFirmwareVersion": 95, "timeZone": "UTC", "dateCreated": "2026-03-10T09:42:21.974754Z", "dateModified": "2026-03-10T09:42:21.976097Z", "messageQueueCount": 0, "decommissioned": false, "restricted": false, "relatedDeviceGroups": [], "reachableGateways": [], "reachableDevices": [] }

Example: Fail to get a business device as an Account

GET/v1/devices/63

header	Authorization	Bearer 7da6c310-b818-4ccb-a0c9-dad7d827839d

Response

status	404
header	Access-Control-Expose-Headers	authorization, content-type
header	Access-Control-Allow-Headers	authorization, content-type
header	Access-Control-Allow-Methods	GET, POST, DELETE, OPTIONS, PUT
header	Access-Control-Allow-Origin	*
header	Strict-Transport-Security	max-age=31536000; includeSubDomains
header	X-Frame-Options	SAMEORIGIN
header	X-Content-Type-Options	nosniff
header	X-XSS-Protection	1; mode=block
header	Content-Security-Policy	default-src 'none'; frame-ancestors 'none'; base-uri 'none'; form-action 'none'
header	Referrer-Policy	no-referrer
header	Feature-Policy	self
header	Permissions-policy	interest-cohort=()
{ "message": "Device 63 not found", "errorMessage": "Device 63 not found" }

Example: Get a personal device as a System Admin

GET/v1/devices/65

header	Authorization	Bearer 85ff49c9-e078-43ee-ac43-bafaef92127e

Response

status	200
header	Access-Control-Expose-Headers	authorization, content-type
header	Access-Control-Allow-Headers	authorization, content-type
header	Access-Control-Allow-Methods	GET, POST, DELETE, OPTIONS, PUT
header	Access-Control-Allow-Origin	*
header	Strict-Transport-Security	max-age=31536000; includeSubDomains
header	X-Frame-Options	SAMEORIGIN
header	X-Content-Type-Options	nosniff
header	X-XSS-Protection	1; mode=block
header	Content-Security-Policy	default-src 'none'; frame-ancestors 'none'; base-uri 'none'; form-action 'none'
header	Referrer-Policy	no-referrer
header	Feature-Policy	self
header	Permissions-policy	interest-cohort=()
{ "id": 65, "name": "Lock1", "organizationId": 33, "organizationName": "", "deviceModel": { "id": 1, "deviceType": { "id": 1, "name": "Lock", "description": "Lock" }, "model": "Smart Cylinder SX", "name": "Smart Cylinder SX" }, "actualFirmwareVersion": 0, "requiredFirmwareVersion": 95, "timeZone": "UTC", "dateCreated": "2026-03-10T09:42:23.917783Z", "dateModified": "2026-03-10T09:42:23.919838Z", "messageQueueCount": 0, "decommissioned": false, "restricted": false, "relatedDeviceGroups": [], "reachableGateways": [], "reachableDevices": [] }

Example: Get a business device as a System Admin

GET/v1/devices/71

header	Authorization	Bearer 81683c3c-d867-48ce-a283-6ef48403b9a0

Response

status	200
header	Access-Control-Expose-Headers	authorization, content-type
header	Access-Control-Allow-Headers	authorization, content-type
header	Access-Control-Allow-Methods	GET, POST, DELETE, OPTIONS, PUT
header	Access-Control-Allow-Origin	*
header	Strict-Transport-Security	max-age=31536000; includeSubDomains
header	X-Frame-Options	SAMEORIGIN
header	X-Content-Type-Options	nosniff
header	X-XSS-Protection	1; mode=block
header	Content-Security-Policy	default-src 'none'; frame-ancestors 'none'; base-uri 'none'; form-action 'none'
header	Referrer-Policy	no-referrer
header	Feature-Policy	self
header	Permissions-policy	interest-cohort=()
{ "id": 71, "name": "Lock1", "organizationId": 36, "organizationName": "", "deviceModel": { "id": 1, "deviceType": { "id": 1, "name": "Lock", "description": "Lock" }, "model": "Smart Cylinder SX", "name": "Smart Cylinder SX" }, "actualFirmwareVersion": 95, "requiredFirmwareVersion": 0, "timeZone": "UTC", "dateCreated": "2026-03-10T09:42:24.858694Z", "dateModified": "2026-03-10T09:42:24.860093Z", "messageQueueCount": 0, "decommissioned": false, "restricted": false, "relatedDeviceGroups": [], "reachableGateways": [], "reachableDevices": [] }