List Unmanaged Devices

Get all Unmanaged Devices

An unmanaged device has a limited set of visible properties, a subset of supported events, and may not be controlled. Any access codes on an unmanaged device will be unmanaged. Convert it to a managed device to control it with Seam.

List Unmanaged Devices

Get a list of unmanaged devices

GET https://connect.getseam.com/devices/unmanaged/list

Retrieve a list of unmanaged devices, optionally filtered

Request Body

Name	Type	Description
connected_account_id	String	ID of Connected Account you'd like to filter by
connect_webview_id	String	ID of Connect Webview you'd like to filter by
device_type	String	Type of Device you'd like to filter with

200: OK

{
  "devices": [
    {
      "device_id": "6b0afc38-7883-4efd-a31d-fccf6c04d809",
      "device_type": "schlage_lock",
      "connected_account_id": "9dcedcb3-5ede-4b66-9e07-f9ef97b3c29b",
      "workspace_id": "f97073eb-c003-467a-965b-e6dba3a0131d",
      "created_at": "2022-08-24T10:38:05.759Z",
      "errors": [],
      "warnings": []
    },
    {
      "device_id": "2aa2c8e6-a255-4548-96fd-8eac38ca031d",
      "device_type": "schlage_lock",
      "connected_account_id": "9dcedcb3-5ede-4b66-9e07-f9ef97b3c29b",
      "workspace_id": "f97073eb-c003-467a-965b-e6dba3a0131d",
      "created_at": "2022-08-24T10:38:05.476Z",
      "errors": [],
      "warnings": []
    },
    {
      "device_id": "70ad4408-78dd-4e29-b0c0-c8f9eb4478d1",
      "device_type": "schlage_lock",
      "connected_account_id": "9dcedcb3-5ede-4b66-9e07-f9ef97b3c29b",
      "workspace_id": "f97073eb-c003-467a-965b-e6dba3a0131d",
      "created_at": "2022-08-24T10:38:05.618Z",
      "errors": [],
      "warnings": []
    }
  ],
  "ok": true
}

Code Example

Python

seam.devices.unmanaged.list()

# [
#     {
#         "device_id": "123e4567-e89b-12d3-a456-426614174000",
#         "device_type": "SCHLAGE_LOCK",
#         "errors": [],
#     }
# ]

Javascript

await seam.devices.unmanaged.list()

/*
[
  {
    device_id: "70ad4408-78dd-4e29-b0c0-c8f9eb4478d1",
    device_type: "schlage_lock",
    connected_account_id: "9dcedcb3-5ede-4b66-9e07-f9ef97b3c29b",
    workspace_id: "f97073eb-c003-467a-965b-e6dba3a0131d",
    created_at: "2022-08-24T10:38:05.618Z",
    errors: [],
    warnings: []
  }
]
*/

Parameters

connected_account_id	type: string Optional	ID of the Connected Account
connected_account_ids	type: string[] Optional	IDs of the Connected Accounts
connect_webview_id	type: string Optional	ID of Connect Webview
device_type	type: String Optional	Device type
manufacturer	type: String Optional	Device manufacturer
device_ids	type: string[] Optional	IDs of the Devices to include

Response

This section shows the JSON response returned by the API. Since each language encapsulates this response inside objects specific to that language and/or implementation, the actual type in your language might differ from what’s written here.

JSON format

JSON

{
  "devices": [
    {
      "device_id": "6b0afc38-7883-4efd-a31d-fccf6c04d809",
      "device_type": "schlage_lock",
      "connected_account_id": "9dcedcb3-5ede-4b66-9e07-f9ef97b3c29b",
      "workspace_id": "f97073eb-c003-467a-965b-e6dba3a0131d",
      "created_at": "2022-08-24T10:38:05.759Z",
      "errors": [],
      "warnings": []
    },
    {
      "device_id": "2aa2c8e6-a255-4548-96fd-8eac38ca031d",
      "device_type": "schlage_lock",
      "connected_account_id": "9dcedcb3-5ede-4b66-9e07-f9ef97b3c29b",
      "workspace_id": "f97073eb-c003-467a-965b-e6dba3a0131d",
      "created_at": "2022-08-24T10:38:05.476Z",
      "errors": [],
      "warnings": []
    },
    {
      "device_id": "70ad4408-78dd-4e29-b0c0-c8f9eb4478d1",
      "device_type": "schlage_lock",
      "connected_account_id": "9dcedcb3-5ede-4b66-9e07-f9ef97b3c29b",
      "workspace_id": "f97073eb-c003-467a-965b-e6dba3a0131d",
      "created_at": "2022-08-24T10:38:05.618Z",
      "errors": [],
      "warnings": []
    }
  ],
  "ok": true
}