search
Sign UpSupported Devices
githubEdit

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 codesarrow-up-right 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"
  }
]
chevron-rightAuthentication Methodshashtag

  • API key

  • Client session token

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

To learn more, see Authenticationarrow-up-right.

hashtag
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.

chevron-rightEnum valueshashtag

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

  • korelock_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

circle-exclamation

Deprecated. Use space_id.

user_identifier_key String

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

hashtag
Response

circle-check

Returns: Array of unmanaged_devices

hashtag
Examples

hashtag
List unmanaged devices for a specific connected account

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

Code:

Output:

hashtag
List unmanaged devices for a specific manufacturer

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

Code:

Output:

hashtag
List unmanaged devices created before a specific date

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

Code:

Output:

PreviousGet an Unmanaged DeviceNextUpdate an Unmanaged Device

Last updated

Was this helpful?