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.

POST /devices/unmanaged/list

JavaScript

Seam SDK

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

/*
[
  {
    "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"
  }
]
*/

200

{
  "devices": [
    {
      "capabilities_supported": [],
      "connected_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2023-11-07T05:31:56Z",
      "custom_metadata": {},
      "device_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "errors": [
        {
          "error_code": "<string>",
          "message": "<string>",
          "created_at": "2023-11-07T05:31:56Z"
        }
      ],
      "properties": {
        "model": {
          "display_name": "<string>",
          "manufacturer_display_name": "<string>",
          "accessory_keypad_supported": true,
          "can_connect_accessory_keypad": true,
          "has_built_in_keypad": true,
          "offline_access_codes_supported": true,
          "online_access_codes_supported": true
        },
        "name": "<string>",
        "online": true,
        "accessory_keypad": {
          "is_connected": true,
          "battery": {
            "level": 0.5
          }
        },
        "battery": {
          "level": 0.5
        },
        "battery_level": 0.5,
        "image_alt_text": "<string>",
        "image_url": "<string>",
        "manufacturer": "<string>",
        "offline_access_codes_enabled": true,
        "online_access_codes_enabled": true
      },
      "warnings": [
        {
          "error_code": "<string>",
          "message": "<string>",
          "created_at": "2023-11-07T05:31:56Z"
        }
      ],
      "workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "can_configure_auto_lock": true,
      "can_hvac_cool": true,
      "can_hvac_heat": true,
      "can_hvac_heat_cool": true,
      "can_program_offline_access_codes": true,
      "can_program_online_access_codes": true,
      "can_program_thermostat_programs_as_different_each_day": true,
      "can_program_thermostat_programs_as_same_each_day": true,
      "can_program_thermostat_programs_as_weekday_weekend": true,
      "can_remotely_lock": true,
      "can_remotely_unlock": true,
      "can_run_thermostat_programs": true,
      "can_simulate_connection": true,
      "can_simulate_disconnection": true,
      "can_simulate_hub_connection": true,
      "can_simulate_hub_disconnection": true,
      "can_simulate_paid_subscription": true,
      "can_simulate_removal": true,
      "can_turn_off_hvac": true,
      "can_unlock_with_code": true,
      "location": {
        "location_name": "<string>",
        "time_zone": "<string>",
        "timezone": "<string>"
      }
    }
  ],
  "ok": true,
  "pagination": {
    "has_next_page": true,
    "next_page_cursor": "<string>",
    "next_page_url": "<string>"
  }
}

Authorizations

api_keypat_with_workspaceconsole_session_with_workspaceclient_session_with_customer

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

connect_webview_id · string<uuid>

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

connected_account_id · string<uuid>

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

connected_account_ids · string<uuid>[]

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

created_before · string<date-time>

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.

Show child attributes

customer_key · string

Customer key for which you want to list devices.

device_ids · string<uuid>[]

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

device_type · Option 1 · enum<string> Option 2 · enum<string> Option 3 · enum<string> Option 4 · enum<string> Option 5 · enum<string> Option 6 · enum<string>

Device type for which you want to list devices.

Available options: 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, smartthings_lock, wyze_lock, yale_lock, two_n_intercom, controlbyweb_device, ttlock_lock, igloohome_lock, four_suites_door, dormakaba_oracode_door, tedee_lock, akiles_lock, ultraloq_lock, korelock_lock

device_types · enum<string>[]

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

Device type for smartlocks.

Available options: 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, smartthings_lock, wyze_lock, yale_lock, two_n_intercom, controlbyweb_device, ttlock_lock, igloohome_lock, four_suites_door, dormakaba_oracode_door, tedee_lock, akiles_lock, ultraloq_lock, korelock_lock

exclude_if · enum<string>[]

Available options: can_remotely_unlock, can_remotely_lock, can_program_offline_access_codes, can_program_online_access_codes, can_hvac_heat, can_hvac_cool, can_hvac_heat_cool, can_turn_off_hvac, can_simulate_removal, can_simulate_connection, can_simulate_disconnection, can_unlock_with_code, can_run_thermostat_programs, can_program_thermostat_programs_as_weekday_weekend, can_program_thermostat_programs_as_different_each_day, can_program_thermostat_programs_as_same_each_day, can_simulate_hub_connection, can_simulate_hub_disconnection, can_simulate_paid_subscription, can_configure_auto_lock

include_if · enum<string>[]

Available options: can_remotely_unlock, can_remotely_lock, can_program_offline_access_codes, can_program_online_access_codes, can_hvac_heat, can_hvac_cool, can_hvac_heat_cool, can_turn_off_hvac, can_simulate_removal, can_simulate_connection, can_simulate_disconnection, can_unlock_with_code, can_run_thermostat_programs, can_program_thermostat_programs_as_weekday_weekend, can_program_thermostat_programs_as_different_each_day, can_program_thermostat_programs_as_same_each_day, can_simulate_hub_connection, can_simulate_hub_disconnection, can_simulate_paid_subscription, can_configure_auto_lock

limit · number<float> · default: 22900

Numerical limit on the number of devices to return.

manufacturer · enum<string>

Manufacturer for which you want to list devices.

Available options: akuvox, august, avigilon_alta, brivo, butterflymx, doorking, four_suites, genie, igloo, keywe, kwikset, linear, lockly, nuki, philia, salto, samsung, schlage, seam, unknown, wyze, yale, two_n, ttlock, igloohome, controlbyweb, dormakaba_oracode, tedee, korelock, akiles, ecobee, honeywell_resideo, keynest, korelock, minut, nest, noiseaware, sensi, smartthings, tado, ultraloq, ring, ical

page_cursor · string | null

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 (full or partial UUID prefix, minimum 4 characters), connected_account_id, display_name, custom_metadata or location.location_name.

Minimum string length: 1

space_id · string<uuid>

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

unstable_location_id · string<uuid> | null · deprecated

user_identifier_key · string

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

Response

200

application/json

OK

devices · object[] · required

Show child attributes

ok · boolean · required

pagination · object · required

Information about the current page of results.

Show child attributes