Ask or search…
K
Links

List Unmanaged Devices

Get all unmanaged devices
Returns a list of all unmanaged devices (device objects). 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.
post
https://connect.getseam.com
/devices/unmanaged/list
/devices/unmanaged/list

Request

List all unmanaged devices or filter the list of unmanaged devices by including the corresponding filter parameter in the request body.

Request Body Parameters

Parameter
Type
Description
connected_account_id
String Optional
ID of the connected account.
connected_account_ids
String[] Optional
IDs of the connected accounts.
connect_webview_id
String Optional
device_type
String Optional
Type of device.
device_types
String[] Optional
Types of devices.
manufacturer
String Optional
Device manufacturer.
device_ids
type: string[] Optional
IDs of the devices to include.
limit
Number Optional
Numerical limit on the number of devices to return.
created_before
String Optional
Date threshold for devices to return. If specified, returns only devices created before the specified date.

Sample Request

Python
cURL (bash)
Javascript
Ruby
C#
Java
pprint(seam.devices.unmanaged.list())
# Use GET or POST.
curl -X 'GET' \
'https://connect.getseam.com/devices/unmanaged/list' \
-H 'accept: application/json' \
-H 'Authorization: Bearer ${API_KEY}' \
-H 'Content-Type: application/json' \
-d '{}'
console.log(await seam.devices.unmanaged.list())
puts client.unmanaged_devices.list().inspect
var unmanagedDevices = seam.UnmanagedDevices.List();
foreach (var unmanagedDevice in unmanagedDevices)
{
Console.WriteLine(unmanagedDevice);
}
var unmanagedDevices = seam.devices().unmanaged().list();
System.out.println(unmanagedDevices);

Response

Returns an unmanaged devices array, in which each returned unmanaged device (device) contains the set of applicable device properties. For details, see Devices.
This response also includes a Boolean ok status indicator.

Sample Response

Python
cURL (bash)
JavaScript
Ruby
C#
Java
[UnmanagedDevice(device_id='2339da8d-ce38-4d86-9bb7-573f95af691c',
device_type='ttlock_lock',
properties={'image_alt_text': 'Placeholder Lock Image',
'image_url': 'https://connect.getseam.com/assets/images/devices/unknown-lock.png',
'manufacturer': 'ttlock',
'model': {'accessory_keypad_supported': False,
'display_name': 'Lock',
'manufacturer_display_name': 'Ttlock',
'offline_access_codes_supported': False,
'online_access_codes_supported': True},
'name': 'Lock 1',
'online': False},
connected_account_id='1769a182-ec97-4266-ba53-27fdb25d2d96',
workspace_id='398d80b7-3f96-47c2-b85a-6f8ba21d07be',
created_at='2023-10-30T08:37:28.852Z',
errors=[{'connected_account_id': '1769a182-ec97-4266-ba53-27fdb25d2d96',
'created_at': '2023-10-31T15:13:58.768Z',
'error_code': 'account_disconnected',
'is_connected_account_error': True,
'message': 'Account Disconnected, you may need to '
'reconnect the account with a new '
'webview. This may happen if the '
'third-party provider triggered an access '
'token to be revoked (e.g. after a '
'password change)'}],
warnings=[],
capabilities_supported=['access_code', 'lock'],
is_managed=False),
UnmanagedDevice(device_id='882dd63f-db9b-4210-bac2-68372aa0aff7',
device_type='august_lock',
...)]
{
"devices": [
{
"is_managed": false,
"device_id": "2339da8d-ce38-4d86-9bb7-573f95af691c",
"device_type": "ttlock_lock",
"connected_account_id": "1769a182-ec97-4266-ba53-27fdb25d2d96",
"capabilities_supported": [
"access_code",
"lock"
],
"workspace_id": "398d80b7-3f96-47c2-b85a-6f8ba21d07be",
"created_at": "2023-10-30T08:37:28.852Z",
"errors": [
{
"error_code": "account_disconnected",
"message": "Account Disconnected, you may need to reconnect the account with a new webview. This may happen if the third-party provider triggered an access token to be revoked (e.g. after a password change)",
"created_at": "2023-10-31T15:13:58.768Z",
"connected_account_id": "1769a182-ec97-4266-ba53-27fdb25d2d96",
"is_connected_account_error": true
}
],
"warnings": [],
"properties": {
"name": "Lock 1",
"online": false,
"manufacturer": "ttlock",
"image_url": "https://connect.getseam.com/assets/images/devices/unknown-lock.png",
"image_alt_text": "Placeholder Lock Image",
"model": {
"display_name": "Lock",
"manufacturer_display_name": "Ttlock",
"accessory_keypad_supported": false,
"offline_access_codes_supported": false,
"online_access_codes_supported": true
}
}
},
{
"is_managed": false,
"device_id": "882dd63f-db9b-4210-bac2-68372aa0aff7",
"device_type": "august_lock",
...
}
],
"ok": true
}
[
{
is_managed: false,
device_id: '2339da8d-ce38-4d86-9bb7-573f95af691c',
device_type: 'ttlock_lock',
connected_account_id: '1769a182-ec97-4266-ba53-27fdb25d2d96',
capabilities_supported: [ 'access_code', 'lock' ],
workspace_id: '398d80b7-3f96-47c2-b85a-6f8ba21d07be',
created_at: '2023-10-30T08:37:28.852Z',
errors: [ [Object] ],
warnings: [],
properties: {
name: 'Lock 1',
online: false,
manufacturer: 'ttlock',
image_url: 'https://connect.getseam.com/assets/images/devices/unknown-lock.png',
image_alt_text: 'Placeholder Lock Image',
model: [Object]
}
},
{
is_managed: false,
device_id: '882dd63f-db9b-4210-bac2-68372aa0aff7',
device_type: 'august_lock',
...
}
]
[<Seam::UnmanagedDevice:0x00438
is_managed=false
device_id="882dd63f-db9b-4210-bac2-68372aa0aff7"
device_type="august_lock"
connected_account_id="f72442d2-2c16-4e3f-9882-6bff21828b1b"
capabilities_supported=["access_code", "lock"]
workspace_id="398d80b7-3f96-47c2-b85a-6f8ba21d07be"
created_at=2023-10-28 09:13:08.836 UTC
errors=[]
warnings=[]
properties={"name"=>"GARAGE", "online"=>true, "manufacturer"=>"august", "image_url"=>"https://connect.getseam.com/assets/images/devices/august_wifi-smart-lock-3rd-gen_silver_front.png", "image_alt_text"=>"August Wifi Smart Lock 3rd Gen, Silver, Front", "model"=>{"display_name"=>"Lock", "manufacturer_display_name"=>"August", "accessory_keypad_supported"=>true, "offline_access_codes_supported"=>false, "online_access_codes_supported"=>true}}>, <Seam::UnmanagedDevice:0x00460
is_managed=false
device_id="2339da8d-ce38-4d86-9bb7-573f95af691c"
device_type="ttlock_lock"
...>]
{
"device_id": "2339da8d-ce38-4d86-9bb7-573f95af691c",
"device_type": "ttlock_lock",
"connected_account_id": "1769a182-ec97-4266-ba53-27fdb25d2d96",
"capabilities_supported": [
"access_code",
"lock"
],
"workspace_id": "398d80b7-3f96-47c2-b85a-6f8ba21d07be",
"errors": [
{
"error_code": "account_disconnected",
"message": "Account Disconnected, you may need to reconnect the account with a new webview. This may happen if the third-party provider triggered an access token to be revoked (e.g. after a password change)"
}
],
"warnings": [],
"created_at": "2023-10-30T08:37:28.852Z",
"properties": {
"name": "Lock 1",
"manufacturer": "ttlock",
"image_url": "https://connect.getseam.com/assets/images/devices/unknown-lock.png",
"image_alt_text": "Placeholder Lock Image",
"model": {
"display_name": "Lock",
"manufacturer_display_name": "Ttlock"
}
}
}
{
"device_id": "882dd63f-db9b-4210-bac2-68372aa0aff7",
"device_type": "august_lock",
...
}
{
"devices" : [ {
"device_id" : "2339da8d-ce38-4d86-9bb7-573f95af691c",
"device_type" : "ttlock_lock",
"connected_account_id" : "1769a182-ec97-4266-ba53-27fdb25d2d96",
"capabilities_supported" : [ "access_code", "lock" ],
"workspace_id" : "398d80b7-3f96-47c2-b85a-6f8ba21d07be",
"errors" : [ {
"error_code" : "account_disconnected",
"message" : "Account Disconnected, you may need to reconnect the account with a new webview. This may happen if the third-party provider triggered an access token to be revoked (e.g. after a password change)",
"connected_account_id" : "1769a182-ec97-4266-ba53-27fdb25d2d96",
"created_at" : "2023-10-31T15:13:58.768Z",
"is_connected_account_error" : true
} ],
"created_at" : "2023-10-30T08:37:28.852Z",
"is_managed" : false,
"properties" : {
"name" : "Lock 1",
"online" : false,
"manufacturer" : "ttlock",
"image_url" : "https://connect.getseam.com/assets/images/devices/unknown-lock.png",
"image_alt_text" : "Placeholder Lock Image",
"model" : {
"display_name" : "Lock",
"online_access_codes_supported" : true,
"accessory_keypad_supported" : false,
"offline_access_codes_supported" : false,
"manufacturer_display_name" : "Ttlock"
}
}
}, {
"device_id" : "882dd63f-db9b-4210-bac2-68372aa0aff7",
"device_type" : "august_lock",
...
} ],
"ok" : true
}