Get an Unmanaged Device

Get a specified unmanaged device

Returns a specified unmanaged device. 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.

/devices/unmanaged/get

post

Returns a specified unmanaged device.

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.

You must specify either device_id or name.

Authorizations

client_sessionpat_with_workspaceconsole_session_with_workspaceapi_key

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

device_idstring · uuidOptional

ID of the unmanaged device that you want to get.

namestringOptional

Name of the unmanaged device that you want to get.

Responses

200

OK

application/json

400

Bad Request

401

Unauthorized

post

/devices/unmanaged/get

HTTPcURLJavaScriptPython

POST /devices/unmanaged/get HTTP/1.1
Host: connect.getseam.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 66

{
  "device_id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text"
}

{
  "device": {
    "device_id": "123e4567-e89b-12d3-a456-426614174000",
    "device_type": "akuvox_lock",
    "connected_account_id": "123e4567-e89b-12d3-a456-426614174000",
    "location": {
      "location_name": "text",
      "timezone": "text"
    },
    "capabilities_supported": [
      "access_code"
    ],
    "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
    "errors": [
      {
        "message": "text",
        "is_device_error": false,
        "created_at": "2025-12-19T03:18:38.211Z",
        "error_code": "account_disconnected",
        "is_connected_account_error": true
      }
    ],
    "warnings": [
      {
        "message": "text",
        "created_at": "2025-12-19T03:18:38.211Z",
        "warning_code": "partial_backup_access_code_pool"
      }
    ],
    "created_at": "2025-12-19T03:18:38.211Z",
    "custom_metadata": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "is_managed": false,
    "properties": {
      "accessory_keypad": {
        "is_connected": true,
        "battery": {
          "level": 1
        }
      },
      "online": true,
      "manufacturer": "text",
      "image_url": "https://example.com",
      "image_alt_text": "text",
      "battery_level": 1,
      "battery": {
        "level": 1,
        "status": "critical"
      },
      "model": {
        "can_connect_accessory_keypad": true,
        "display_name": "text",
        "manufacturer_display_name": "text",
        "has_built_in_keypad": true
      }
    },
    "can_remotely_unlock": true,
    "can_remotely_lock": true,
    "can_program_offline_access_codes": true,
    "can_program_online_access_codes": true,
    "can_hvac_heat": true,
    "can_hvac_cool": true,
    "can_hvac_heat_cool": true,
    "can_turn_off_hvac": true,
    "can_simulate_removal": true,
    "can_simulate_connection": true,
    "can_simulate_disconnection": true,
    "can_unlock_with_code": true,
    "can_run_thermostat_programs": true,
    "can_program_thermostat_programs_as_weekday_weekend": true,
    "can_program_thermostat_programs_as_different_each_day": true,
    "can_program_thermostat_programs_as_same_each_day": true,
    "can_simulate_hub_connection": true,
    "can_simulate_hub_disconnection": true,
    "can_simulate_paid_subscription": true
  },
  "ok": true
}

Request

Specify the desired unmanaged device by including the corresponding device_id in the request body.

Request Body Parameters

Parameter	Type	Description
device_id	String Required	ID of the desired device.

Sample Request

Python

pprint(seam.devices.unmanaged.get("882dd63f-db9b-4210-bac2-68372aa0aff7"))

cURL (bash)

JavaScript

Ruby

C#

Response

Returns an unmanaged device that contains the set of applicable device properties. For details, see Devices.

This response also includes a Boolean ok status indicator.

Sample Response

Python

UnmanagedDevice(device_id='882dd63f-db9b-4210-bac2-68372aa0aff7',
                device_type='august_lock',
                properties={'image_alt_text': 'August Wifi Smart Lock 3rd Gen, '
                                              'Silver, Front',
                            'image_url': 'https://connect.getseam.com/assets/images/devices/august_wifi-smart-lock-3rd-gen_silver_front.png',
                            'manufacturer': 'august',
                            'model': {'accessory_keypad_supported': True,
                                      'display_name': 'Lock',
                                      'manufacturer_display_name': 'August',
                                      'offline_access_codes_supported': False,
                                      'online_access_codes_supported': True},
                            'name': 'GARAGE',
                            'online': True},
                connected_account_id='f72442d2-2c16-4e3f-9882-6bff21828b1b',
                workspace_id='398d80b7-3f96-47c2-b85a-6f8ba21d07be',
                created_at='2023-10-28T09:13:08.836Z',
                errors=[],
                warnings=[],
                capabilities_supported=['access_code', 'lock'],
                is_managed=False)

cURL (bash)

JavaScript

Ruby

C#