Get an Unmanaged Device
Get a specified unmanaged device
Returns a specified unmanaged device. An unmanaged device has a limited set of visible properties and a subset of supported events. You cannot control an unmanaged device. Any access codes on an unmanaged device are unmanaged. To control an unmanaged device with Seam, convert it to a managed device.
Returns a specified unmanaged device.
An unmanaged device has a limited set of visible properties and a subset of supported events. You cannot control an unmanaged device. Any access codes on an unmanaged device are unmanaged. To control an unmanaged device with Seam, convert it to a managed device.
You must specify either device_id
or name
.
ID of the unmanaged device that you want to get.
Name of the unmanaged device that you want to get.
POST /devices/unmanaged/get HTTP/1.1
Host: connect.getseam.com
Authorization: Bearer Client Session Token
Content-Type: application/json
Accept: */*
Content-Length: 66
{
"device_id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text"
}
{
"device": {
"device_id": "123e4567-e89b-12d3-a456-426614174000",
"device_type": "akuvox_lock",
"connected_account_id": "123e4567-e89b-12d3-a456-426614174000",
"location": {
"location_name": "text",
"timezone": "text"
},
"capabilities_supported": [
"access_code"
],
"workspace_id": "123e4567-e89b-12d3-a456-426614174000",
"errors": [
{
"message": "text",
"is_device_error": false,
"created_at": "2025-07-04T09:05:08.411Z",
"error_code": "account_disconnected",
"is_connected_account_error": true
}
],
"warnings": [
{
"message": "text",
"created_at": "2025-07-04T09:05:08.411Z",
"warning_code": "partial_backup_access_code_pool"
}
],
"created_at": "2025-07-04T09:05:08.411Z",
"is_managed": false,
"properties": {
"accessory_keypad": {
"is_connected": true,
"battery": {
"level": 1
}
},
"online": true,
"manufacturer": "text",
"image_url": "https://example.com",
"image_alt_text": "text",
"battery_level": 1,
"battery": {
"level": 1,
"status": "critical"
},
"online_access_codes_enabled": true,
"offline_access_codes_enabled": true,
"model": {
"can_connect_accessory_keypad": true,
"display_name": "text",
"manufacturer_display_name": "text",
"has_built_in_keypad": true
}
},
"can_remotely_unlock": true,
"can_remotely_lock": true,
"can_program_offline_access_codes": true,
"can_program_online_access_codes": true,
"can_hvac_heat": true,
"can_hvac_cool": true,
"can_hvac_heat_cool": true,
"can_turn_off_hvac": true,
"can_simulate_removal": true,
"can_simulate_connection": true,
"can_simulate_disconnection": true,
"can_unlock_with_code": true
},
"ok": true
}
Request
Specify the desired unmanaged device by including the corresponding device_id
in the request body.
Request Body Parameters
device_id
String Required
ID of the desired device.
Sample Request
pprint(seam.devices.unmanaged.get("882dd63f-db9b-4210-bac2-68372aa0aff7"))
Response
Returns an unmanaged device
that contains the set of applicable device properties. For details, see Devices.
This response also includes a Boolean ok
status indicator.
Sample Response
UnmanagedDevice(device_id='882dd63f-db9b-4210-bac2-68372aa0aff7',
device_type='august_lock',
properties={'image_alt_text': 'August Wifi Smart Lock 3rd Gen, '
'Silver, Front',
'image_url': 'https://connect.getseam.com/assets/images/devices/august_wifi-smart-lock-3rd-gen_silver_front.png',
'manufacturer': 'august',
'model': {'accessory_keypad_supported': True,
'display_name': 'Lock',
'manufacturer_display_name': 'August',
'offline_access_codes_supported': False,
'online_access_codes_supported': True},
'name': 'GARAGE',
'online': True},
connected_account_id='f72442d2-2c16-4e3f-9882-6bff21828b1b',
workspace_id='398d80b7-3f96-47c2-b85a-6f8ba21d07be',
created_at='2023-10-28T09:13:08.836Z',
errors=[],
warnings=[],
capabilities_supported=['access_code', 'lock'],
is_managed=False)
Last updated
Was this helpful?