Sign UpSupported Devices
Edit

List Unmanaged Devices

Returns a list of all unmanaged devices.

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 list of all unmanaged devices for a specified customer ID.

Code:

await seam.devices.unmanaged.list({
  customer_ids: ["e387e15f-be27-47ad-881f-4a6fc5460c57"],
});

Output:

[
  {
    "can_program_offline_access_codes": false,
    "can_program_online_access_codes": true,
    "can_remotely_lock": true,
    "can_remotely_unlock": true,
    "can_simulate_connection": false,
    "can_simulate_disconnection": true,
    "can_simulate_removal": true,
    "capabilities_supported": ["access_code", "lock"],
    "connected_account_id": "c1a3967f-24a1-4220-a9c7-7fa97c1d5603",
    "created_at": "2025-06-16T16:54:17.946342Z",
    "device_id": "f4f40e75-86fc-4896-b958-e1c7e092b2cf",
    "device_type": "schlage_lock",
    "errors": [],
    "is_managed": false,
    "location": {
      "location_name": "Front Door",
      "timezone": "America/New_York"
    },
    "properties": {
      "accessory_keypad": { "battery": { "level": 1 }, "is_connected": true },
      "battery": { "level": 1, "status": "full" },
      "battery_level": 1,
      "image_alt_text": "Schlage Sense Smart Deadbolt with Camelot Trim, Front",
      "image_url": "https://connect.getseam.com/_next/image?url=https://connect.getseam.com/assets/images/devices/schlage_sense-smart-deadbolt-with-camelot-trim_front.png&q=75&w=128",
      "manufacturer": "schlage",
      "model": {
        "accessory_keypad_supported": true,
        "can_connect_accessory_keypad": true,
        "display_name": "Front Door",
        "has_built_in_keypad": false,
        "manufacturer_display_name": "Schlage",
        "offline_access_codes_supported": false,
        "online_access_codes_supported": true
      },
      "name": "Front Door",
      "offline_access_codes_enabled": false,
      "online": true,
      "online_access_codes_enabled": true
    },
    "warnings": [],
    "workspace_id": "3cd6ba1c-8a60-4c24-b487-07bf6c0b755b"
  }
]
Authentication Methods

  • API key

  • Personal access token Must also include the seam-workspace header in the request.

To learn more, see Authentication.

Request Parameters

connect_webview_id String

ID of the Connect Webview for which you want to list devices.

connected_account_id String

ID of the connected account for which you want to list devices.

connected_account_ids Array of UUIDs

Array of IDs of the connected accounts for which you want to list devices.

created_before String

Timestamp by which to limit returned devices. Returns devices created before this timestamp.

custom_metadata_has Object

Set of key:value custom metadata pairs for which you want to list devices.

customer_key String

Customer key for which you want to list devices.

device_ids Array of UUIDs

Array of device IDs for which you want to list devices.

device_type String

Device type for which you want to list devices.

device_types Array of Enums

Array of device types for which you want to list devices.

Enum values

Possible enum values:

  • akuvox_lock

  • august_lock

  • brivo_access_point

  • butterflymx_panel

  • avigilon_alta_entry

  • doorking_lock

  • genie_door

  • igloo_lock

  • linear_lock

  • lockly_lock

  • kwikset_lock

  • nuki_lock

  • salto_lock

  • schlage_lock

  • seam_relay

  • smartthings_lock

  • wyze_lock

  • yale_lock

  • two_n_intercom

  • controlbyweb_device

  • ttlock_lock

  • igloohome_lock

  • hubitat_lock

  • four_suites_door

  • dormakaba_oracode_door

  • tedee_lock

  • akiles_lock

  • ultraloq_lock

  • keynest_key

  • noiseaware_activity_zone

  • minut_sensor

  • ecobee_thermostat

  • nest_thermostat

  • honeywell_resideo_thermostat

  • tado_thermostat

  • sensi_thermostat

  • smartthings_thermostat

  • ios_phone

  • android_phone

limit Number

Numerical limit on the number of devices to return.

manufacturer String

Manufacturer for which you want to list devices.

page_cursor String

Identifies the specific page of results to return, obtained from the previous page's next_page_cursor.

search String

String for which to search. Filters returned devices to include all records that satisfy a partial match using device_id, display_name, custom_metadata or location.location_name.

space_id String

ID of the space for which you want to list devices.

unstable_location_id String

Deprecated. Use space_id.

user_identifier_key String

Your own internal user ID for the user for which you want to list devices.

Response

Array of unmanaged_devices

{
  "can_program_offline_access_codes": false,
  "can_program_online_access_codes": true,
  "can_remotely_lock": true,
  "can_remotely_unlock": true,
  "can_simulate_connection": false,
  "can_simulate_disconnection": true,
  "can_simulate_removal": true,
  "capabilities_supported": ["access_code", "lock"],
  "connected_account_id": "c1a3967f-24a1-4220-a9c7-7fa97c1d5603",
  "created_at": "2025-06-16T16:54:17.946342Z",
  "device_id": "f4f40e75-86fc-4896-b958-e1c7e092b2cf",
  "device_type": "schlage_lock",
  "errors": [],
  "is_managed": false,
  "location": { "location_name": "Front Door", "timezone": "America/New_York" },
  "custom_metadata": { "id": "internalId1" },
  "properties": {
    "accessory_keypad": { "battery": { "level": 1 }, "is_connected": true },
    "battery": { "level": 1, "status": "full" },
    "battery_level": 1,
    "image_alt_text": "Schlage Sense Smart Deadbolt with Camelot Trim, Front",
    "image_url": "https://connect.getseam.com/_next/image?url=https://connect.getseam.com/assets/images/devices/schlage_sense-smart-deadbolt-with-camelot-trim_front.png&q=75&w=128",
    "manufacturer": "schlage",
    "model": {
      "accessory_keypad_supported": true,
      "can_connect_accessory_keypad": true,
      "display_name": "Front Door",
      "has_built_in_keypad": false,
      "manufacturer_display_name": "Schlage",
      "offline_access_codes_supported": false,
      "online_access_codes_supported": true
    },
    "name": "Front Door",
    "offline_access_codes_enabled": false,
    "online": true,
    "online_access_codes_enabled": true
  },
  "warnings": [],
  "workspace_id": "3cd6ba1c-8a60-4c24-b487-07bf6c0b755b"
}

Examples

List unmanaged devices for a specific connected account

Returns a list of all unmanaged devices for a specified connected account ID.

Code:

await seam.devices.unmanaged.list({
  connected_account_id: "c1a3967f-24a1-4220-a9c7-7fa97c1d5603",
});

Output:

[
  {
    "can_program_offline_access_codes": false,
    "can_program_online_access_codes": true,
    "can_remotely_lock": true,
    "can_remotely_unlock": true,
    "can_simulate_connection": false,
    "can_simulate_disconnection": true,
    "can_simulate_removal": true,
    "capabilities_supported": ["access_code", "lock"],
    "connected_account_id": "c1a3967f-24a1-4220-a9c7-7fa97c1d5603",
    "created_at": "2025-06-16T16:54:17.946342Z",
    "device_id": "f4f40e75-86fc-4896-b958-e1c7e092b2cf",
    "device_type": "schlage_lock",
    "errors": [],
    "is_managed": false,
    "location": {
      "location_name": "Front Door",
      "timezone": "America/New_York"
    },
    "properties": {
      "accessory_keypad": { "battery": { "level": 1 }, "is_connected": true },
      "battery": { "level": 1, "status": "full" },
      "battery_level": 1,
      "image_alt_text": "Schlage Sense Smart Deadbolt with Camelot Trim, Front",
      "image_url": "https://connect.getseam.com/_next/image?url=https://connect.getseam.com/assets/images/devices/schlage_sense-smart-deadbolt-with-camelot-trim_front.png&q=75&w=128",
      "manufacturer": "schlage",
      "model": {
        "accessory_keypad_supported": true,
        "can_connect_accessory_keypad": true,
        "display_name": "Front Door",
        "has_built_in_keypad": false,
        "manufacturer_display_name": "Schlage",
        "offline_access_codes_supported": false,
        "online_access_codes_supported": true
      },
      "name": "Front Door",
      "offline_access_codes_enabled": false,
      "online": true,
      "online_access_codes_enabled": true
    },
    "warnings": [],
    "workspace_id": "3cd6ba1c-8a60-4c24-b487-07bf6c0b755b"
  }
]

List unmanaged devices for a specific manufacturer

Returns a list of all unmanaged devices for a specified manufacturer.

Code:

await seam.devices.unmanaged.list({ manufacturer: "schlage" });

Output:

[
  {
    "can_program_offline_access_codes": false,
    "can_program_online_access_codes": true,
    "can_remotely_lock": true,
    "can_remotely_unlock": true,
    "can_simulate_connection": false,
    "can_simulate_disconnection": true,
    "can_simulate_removal": true,
    "capabilities_supported": ["access_code", "lock"],
    "connected_account_id": "c1a3967f-24a1-4220-a9c7-7fa97c1d5603",
    "created_at": "2025-06-16T16:54:17.946342Z",
    "device_id": "f4f40e75-86fc-4896-b958-e1c7e092b2cf",
    "device_type": "schlage_lock",
    "errors": [],
    "is_managed": false,
    "location": {
      "location_name": "Front Door",
      "timezone": "America/New_York"
    },
    "properties": {
      "accessory_keypad": { "battery": { "level": 1 }, "is_connected": true },
      "battery": { "level": 1, "status": "full" },
      "battery_level": 1,
      "image_alt_text": "Schlage Sense Smart Deadbolt with Camelot Trim, Front",
      "image_url": "https://connect.getseam.com/_next/image?url=https://connect.getseam.com/assets/images/devices/schlage_sense-smart-deadbolt-with-camelot-trim_front.png&q=75&w=128",
      "manufacturer": "schlage",
      "model": {
        "accessory_keypad_supported": true,
        "can_connect_accessory_keypad": true,
        "display_name": "Front Door",
        "has_built_in_keypad": false,
        "manufacturer_display_name": "Schlage",
        "offline_access_codes_supported": false,
        "online_access_codes_supported": true
      },
      "name": "Front Door",
      "offline_access_codes_enabled": false,
      "online": true,
      "online_access_codes_enabled": true
    },
    "warnings": [],
    "workspace_id": "3cd6ba1c-8a60-4c24-b487-07bf6c0b755b"
  }
]

List unmanaged devices created before a specific date

Returns a list of all unmanaged devices created (in Seam) before a specified date.

Code:

await seam.devices.unmanaged.list({
  created_before: "2025-01-01T00:00:00.000Z",
  limit: 50,
});

Output:

[
  {
    "can_program_offline_access_codes": false,
    "can_program_online_access_codes": true,
    "can_remotely_lock": true,
    "can_remotely_unlock": true,
    "can_simulate_connection": false,
    "can_simulate_disconnection": true,
    "can_simulate_removal": true,
    "capabilities_supported": ["access_code", "lock"],
    "connected_account_id": "c1a3967f-24a1-4220-a9c7-7fa97c1d5603",
    "created_at": "2024-06-16T16:54:17.946342Z",
    "device_id": "f4f40e75-86fc-4896-b958-e1c7e092b2cf",
    "device_type": "schlage_lock",
    "errors": [],
    "is_managed": false,
    "location": {
      "location_name": "Front Door",
      "timezone": "America/New_York"
    },
    "properties": {
      "accessory_keypad": { "battery": { "level": 1 }, "is_connected": true },
      "battery": { "level": 1, "status": "full" },
      "battery_level": 1,
      "image_alt_text": "Schlage Sense Smart Deadbolt with Camelot Trim, Front",
      "image_url": "https://connect.getseam.com/_next/image?url=https://connect.getseam.com/assets/images/devices/schlage_sense-smart-deadbolt-with-camelot-trim_front.png&q=75&w=128",
      "manufacturer": "schlage",
      "model": {
        "accessory_keypad_supported": true,
        "can_connect_accessory_keypad": true,
        "display_name": "Front Door",
        "has_built_in_keypad": false,
        "manufacturer_display_name": "Schlage",
        "offline_access_codes_supported": false,
        "online_access_codes_supported": true
      },
      "name": "Front Door",
      "offline_access_codes_enabled": false,
      "online": true,
      "online_access_codes_enabled": true
    },
    "warnings": [],
    "workspace_id": "3cd6ba1c-8a60-4c24-b487-07bf6c0b755b"
  }
]
PreviousGet an Unmanaged DeviceNextUpdate an Unmanaged Device

Last updated

Was this helpful?