LogoLogo
Sign UpSupported Devices
  • Seam Documentation
  • 🚲Quick Start
  • 🚀Go Live!
  • Core Concepts
    • Overview
    • Seam Console
      • Seam Online CLI
    • Workspaces
    • Authentication
      • API Keys
      • Personal Access Tokens
      • Client Sessions and Client Session Tokens
        • Implementing Client Sessions for Device Management in the Backend
    • Connect Webviews
      • Connect Webview Process
      • Embedding a Connect Webview in Your App
      • Verifying Successful Account Connection
      • Retrieving Devices or Access Control Systems Connected Through a Connect Webview
      • Attaching Custom Metadata to the Connect Webview
      • Filtering Connect Webviews by Custom Metadata
      • Customizing Connect Webviews
    • Devices
      • Displaying Device Health
      • Displaying Device Power Status
      • Managed and Unmanaged Devices
      • Adding Custom Metadata to a Device
      • Filtering Devices by Custom Metadata
      • Handling Device Errors
      • Testing Your App Against Device Disconnection and Removal
    • Providers
      • Provider Metadata
    • Connected Accounts
      • Adding Custom Metadata to a Connected Account
      • Filtering Connected Accounts by Custom Metadata
      • Reconnecting an Account
    • Action Attempts
  • Capability Guides
    • 📋Device and System Capabilities
    • 🔒Smart Locks
      • Locking and Unlocking Smart Locks
      • Creating and Managing Smart Lock Access Codes
        • Creating Access Codes
          • Understanding Code Constraints
        • Retrieving Access Codes
        • Modifying Access Codes
        • Deleting Access Codes
        • Lifecycle of Access Codes
        • Access Code Requirements for Door Locks
        • Streamlining Access Code Management from the Manufacturer App
        • Troubleshooting Access Codes
        • Managing Backup Access Codes
        • Managing Offline Access Codes
        • Creating and Updating Multiple Linked Access Codes
        • Migrating Existing Unmanaged Access Codes
    • 🏢Access Control Systems
      • ACS Quick Starts
        • PIN Code Quick Start
        • Encodable Key Card Quick Start
        • Mobile Key Quick Start
      • Connect an ACS to Seam
        • Retrieving ACS System Details
        • Access Control System Resources
        • Understanding Access Control System Differences
      • Managing ACS Users
        • Suspending and Unsuspending ACS Users
        • Assigning ACS Users to Access Groups
      • Retrieving Entrance Details
      • Managing Credentials
        • Assigning Credentials to ACS Users
        • Listing Credentials and Associated Entrances
      • Working with Card Encoders and Scanners
        • Creating and Encoding Card-based Credentials
        • Scanning Encoded Cards
      • Troubleshooting Your Access Control System
    • 📱Mobile Access
      • Prepare your Workspace
      • Managing Mobile App User Accounts with User Identities
      • Managing Phones for a User Identity
      • Issuing Mobile Credentials from an Access Control System
      • Developing in a Sandbox Workspace
      • Integrating into your Mobile Application
        • Initializing the Seam Mobile SDK
        • Handling System Permissions
        • Using Unlock With Tap
    • 🌡️Thermostats
      • Understanding Thermostat Concepts
        • HVAC Mode
        • Set Points
      • Retrieving Thermostats
      • Setting and Monitoring Temperature Thresholds
      • Setting the Current HVAC and Fan Mode Settings
      • Creating and Managing Climate Presets
        • Setting the Fallback Climate Preset
        • Activating a Climate Preset
      • Creating and Managing Thermostat Schedules
      • Creating and Managing Thermostat Programs
      • Testing Your Thermostat App with Simulate Endpoints
    • 👂Noise Sensors
      • Configuring Noise Threshold Settings
    • 📡Seam Bridge
  • 💻UI Components
    • 🧱Seam Components
      • Getting Started with Seam Components
        • Get Started with React
        • Get started with Angular
        • Get started with Vue
        • Get started with Client Side Components
      • Components
        • Device Details
        • Device Table
        • Access Code Table
        • Access Code Details
        • Create Access Code Form
        • Update Access Code Form
        • Supported Devices Table
        • Seam Provider
        • Connect Account Button
      • Make a Supported Devices Page
      • Using User Identities to Scope Users' Device Access
  • 📋API Reference
    • Overview
    • Installation
    • Authentication
    • Access Codes
      • Create an Access Code
      • Create Multiple Linked Access Codes
      • List Access Codes
      • Get an Access Code
      • Update an Access Code
      • Update Multiple Linked Access Codes
      • Delete an Access Code
      • Pull a Backup Access Code
      • Report Device Access Code Constraints
      • Unmanaged Access Codes
        • List Unmanaged Access Codes
        • Get an Unmanaged Access Code
        • Convert an Unmanaged Access Code
        • Update an Unmanaged Access Code
        • Delete an Unmanaged Access Code
      • Access Code Simulations
        • Simulate Creating an Unmanaged Access Code
    • Access Control Systems (ACS)
      • Systems
        • List ACS Systems
        • Get an ACS System
        • List Compatible Credential Manager ACS Systems
      • ACS Users
        • Create an ACS User
        • List ACS Users
        • Get an ACS User
        • Update an ACS User
        • Suspend an ACS User
        • Unsuspend an ACS User
        • Delete an ACS User
        • Add an ACS User to an Access Group
        • Remove an ACS User from an Access Group
      • Entrances
        • List Entrances
        • Get an Entrance
        • List Credentials with Access to an Entrance
      • Access Groups
        • List Access Groups
        • Get an Access Group
        • Add an ACS User to an Access Group
        • Remove an ACS User from an Access Group
        • List ACS Users in an Access Group
      • Credentials
        • Create a Credential for an ACS User
        • Assign a Credential to an ACS User
        • List Credentials
        • Get a Credential
        • Update a Credential
        • Unassign a Credential from an ACS User
        • Delete a Credential
        • List Accessible Entrances
      • Encoders
        • Encode a Credential
        • List Encoders
        • Get an Encoder
        • Scan a Credential
        • Encoder Simulations
          • Simulate that the Next Credential Encoding Will Fail
          • Simulate that the Next Credential Encoding Will Succeed
          • Simulate that the Next Credential Scan Will Fail
          • Simulate that the Next Credential Scan Will Succeed
    • Action Attempts
      • Get Action Attempt
    • Client Sessions
      • Create a Client Session
      • Get or Create a Client Session
      • List Client Sessions
      • Get a Client Session
      • Grant Access to a Client Session
      • Delete a Client Session
    • Connect Webviews
      • Create a Connect Webview
      • List Connect Webviews
      • Get a Connect Webview
      • Delete a Connect Webview
    • Connected Accounts
      • Get a Connected Account
      • List Connected Accounts
      • Update a Connected Account
      • Delete a Connected Account
    • Devices
      • List Devices
      • List Device Providers
      • Get a Device
      • Update a Device
      • Unmanaged Devices
        • Update an Unmanaged Device
        • List Unmanaged Devices
        • Get an Unmanaged Device
    • Events
      • List Events
      • Get an Event
    • Locks
      • Get Lock
      • Lock a Lock
      • Unlock a Lock
      • List Locks
    • Noise Sensors
      • Noise Thresholds
        • Create Noise Thresholds
        • List Noise Thresholds
        • Update Noise Threshold
        • Delete Noise Threshold
    • Phones
      • Get a Phone
      • List Phones
      • Deactivate a Phone
      • Phone Simulations
        • Create a Sandbox Phone
    • Thermostats
      • List Thermostats
      • Set to Heat Mode
      • Set to Cool Mode
      • Set to Heat-Cool (Auto) Mode
      • Set to Off Mode
      • Set the HVAC Mode
      • Set Fan Mode
      • Activate a Climate Preset
      • Create a Climate Preset
      • Update a Climate Preset
      • Delete a Climate Preset
      • Set a Fallback Climate Preset
      • Set a Temperature Threshold
      • Thermostat Schedules
        • Get a Thermostat Schedule
        • List Thermostat Schedules
        • Create a Thermostat Schedule
        • Update a Thermostat Schedule
        • Delete a Thermostat Schedule
      • Thermostat Simulations
        • Temperature Reached
        • HVAC Mode Adjusted
    • User Identities
      • Create a User Identity
      • List User Identities
      • Get a User Identity
      • Update a User Identity
      • Add an ACS User to a User Identity
      • List ACS Users Associated with a User Identity
      • List ACS Systems Associated with a User Identity
      • Remove an ACS User from a User Identity
      • Grant a User Identity Access to a Device
      • List Accessible Devices for a User Identity
      • Revoke Access to a Device from a User Identity
      • Delete a User Identity
      • Enrollment Automations
        • Launch an Enrollment Automation
        • List Enrollment Automations
        • Get an Enrollment Automation
        • Delete an Enrollment Automation
    • Workspaces
      • Get Workspace
      • Reset Workspace
  • 🛠️Developer Tools
    • Webhooks
    • Seam CLI
    • Sandbox Devices and Systems
      • Sandbox 2N Intercoms
      • Sandbox 4SUITES Locks
      • Sandbox Akiles Locks
      • Sandbox ASSA ABLOY Credential Services
      • Sandbox ASSA ABLOY Visionline Access Control System
      • Sandbox August Locks
      • Sandbox Avigilon Alta Access System
      • Sandbox Brivo Access
      • Sandbox ControlByWeb Relays
      • Sandbox Doorking Callboxes
      • Sandbox dormakaba Oracode Locks
      • Sandbox ecobee Thermostats
      • Sandbox Genie Garage Openers
      • Sandbox Google Nest Thermostats
      • Sandbox Honeywell Resideo Thermostats
      • Sandbox igloohome Locks
      • Sandbox Kwikset Locks
      • Sandbox Latch Access Control System
      • Sandbox Linear Callboxes
      • Sandbox Lockly Locks
      • Sandbox Minut Sensors
      • Sandbox NoiseAware Sensors
      • Sandbox Nuki Locks
      • Sandbox PTI Storlogix Cloud
      • Sandbox Salto KS Access Control System
      • Sandbox Salto Locks
      • Sandbox Salto Space Access System
      • Sandbox Schlage Encode Locks
      • Sandbox Seam Bridge
      • Sandbox Sensi Thermostats
      • Sandbox SmartThings Hub
      • Sandbox Tedee Locks
      • Sandbox TTLock Locks
      • Sandbox Wyze Locks
      • Sandbox Yale Locks
    • Rate Limits and Guardrails
    • Mobile SDKs
      • Android SDK
      • iOS SDK
  • 🎛️Device and System Integration Guides
    • Overview
    • 2N Intercom Systems
      • Get started with 2N Intercoms
    • 33 Lock Devices
      • Get started with 33 Lock devices
    • 4SUITES Locks
      • Get started with 4SUITES locks
    • Akiles Locks
      • Get started with Akiles locks
    • ASSA ABLOY Credential Services
    • ASSA ABLOY Visionline Access Control System
      • Visionline ACS Setup Instructions
        • Developing and Launching Your Visionline Plastic Card Encoding App
          • Developing Your Visionline Plastic Card Encoding App Using a Real Visionline Server
            • Step 1: Install Your Visionline Application
            • Step 2: Unblock Required Ports
            • Step 3: Configure a Visionline User Account
            • Step 4: Install a Visionline Card Encoder
            • Step 5: Set up Door Locks
            • Step 6: Program Door Locks
            • Step 7: Create a Production Workspace
            • Step 8: Connect Your Visionline Development Account to Seam
            • Next Steps
          • Developing Your Visionline Plastic Card Encoding App Using a Sandbox Workspace
            • Step 1: Create a Sandbox Workspace
            • Step 2: Connect the Virtual Visionline ACS to Seam
            • Next Steps
          • Launching Your Visionline Plastic Card Encoding App to a Live Site
            • Step 1: Confirm That Your Visionline Site Meets the Requirements
            • Step 2: Configure a Visionline User Account
            • Step 3: Purchase and Import the Callback Option from ASSA ABLOY
            • Step 4: Create a Production Workspace
            • Step 5: Connect Your Visionline Production Account to Seam
        • Developing and Launching Your Visionline Mobile Key App
          • Developing Your Visionline Mobile Key App
            • Step 1: Complete the ASSA ABLOY Mobile Development Course
            • Step 2: Install Your Visionline Application
            • Step 3: Unblock Required Ports
            • Step 4: Configure a Visionline User Account
            • Step 5: Set up Your Credential Services Account in Visionline
            • Step 6: Configure the Mobile Access UUID in Visionline
            • Step 7: Set up Door Locks with BLE Profiles
            • Step 8: Program Door Locks
            • Step 9: Create a Production Workspace
            • Step 10: Connect Your Visionline Development Account to Seam
            • Next Steps
          • Launching Your Visionline Mobile Key App
            • Step 1: Obtain ASSA ABLOY Certification for Your Mobile Key App
            • Step 2: Confirm That Your Visionline Site Meets the Requirements
            • Step 3: Confirm BLE Module on All Locks
            • Step 4: Set up Door Locks with BLE Profiles
            • Step 5: Program Door Locks
            • Step 6: Configure a Visionline User Account
            • Step 7: Purchase and Import the Callback and Mobile Service Options from ASSA ABLOY
            • Step 8: Create a Production Workspace
            • Step 9: Connect Your Visionline Production Account to Seam
      • Configuring Visionline Mobile Credentials
        • Issuing Various Types of Guest Mobile Credentials
        • Issuing Various Types of Guest Joiner Mobile Credentials
        • Retrieving Guest and Common Entrances
        • Checking if a User Identity Has a Phone That Is Set up for a Credential Manager
        • Updating Guest Mobile Credentials
        • Revoking Mobile Credentials
      • Mobile Credential-Related Properties
      • Common Use Cases
      • Special Requirements for Android Mobile Access SDK Development
      • Special Requirements for iOS Mobile Access SDK Development
      • Creating Visionline Card-based Credentials
    • August Locks
      • Get started with August locks
    • Avigilon Alta Access System
    • Brivo Access
    • Get started with ControlByWeb Devices
    • dormakaba Oracode Locks
      • Get started with dormakaba Oracode Locks
      • Creating dormakaba Oracode Offline Access Codes
    • ecobee Thermostats
      • Get Started with ecobee Thermostats
    • Google Nest Thermostats
      • Get Started with Nest Thermostats
      • Obtain Google Nest Device Access and Commercial Development
    • Honeywell Resideo Thermostats
      • Get Started with Honeywell Resideo Thermostats
    • igloohome Locks
      • Get started with igloohome Locks
      • Creating igloohome Offline Access Codes
    • Kwikset Locks
      • Get started with Kwikset Wi-Fi Locks
    • Latch Access Control System
      • Latch ACS Setup Instructions
      • Programming Code-Based Latch Credentials
      • Programming Latch ACS Mobile Credentials
    • Lockly Locks
      • Creating Lockly Offline Access Codes
    • Minut Sensors
      • Get started with Minut Sensors
    • NoiseAware Sensors
      • Get started with NoiseAware Sensors
    • Nuki Locks
      • Get Started with Nuki Locks
    • PTI Storlogix Cloud
    • Salto KS Access Control System
      • Salto KS Setup Instructions
      • Programming Salto KS PIN Code Credentials
      • Programming Salto KS Mobile Credentials
      • Special Requirements for Android Mobile Access SDK Development
    • Salto KS Locks
      • Get started with Salto KS Locks
    • Salto ProAccess Space Access System
      • Salto Space Setup Instructions
      • Programming Salto Space Card-based Credentials
      • Programming Salto Space Mobile Credentials
    • Schlage Locks
      • Schlage Locks Setup Instructions
      • Get started with Schlage Locks
    • Sensi Thermostats
      • Get Started with Sensi Thermostats
    • Get started with SmartThings Hubs + Smart Locks
    • Tedee Locks
      • Get Started with Tedee Locks
    • TTLock Locks
      • Get started with TTLock Locks
    • Wyze Locks
      • Get started with Wyze Locks
    • Yale Locks
      • Get started with Yale Locks
    • Get started with Smart Locks
  • Device Manufacturer Guidance
    • Creating a Seam-Compatible Intercom API
      • Creating OAuth Endpoints
      • Creating Intercom CRUD Endpoints
      • Creating Access Code CRUD Endpoints
      • Creating the Health Endpoint
    • Creating a Seam-Compatible Door Locks API
      • Creating OAuth Endpoints
      • Creating Door Lock CRUD Endpoints
      • Creating Access Code CRUD Endpoints
      • Creating the Health Endpoint
Powered by GitBook
LogoLogo

Get Started

  • Sign Up
  • Supported Devices

News

  • Changelog
  • Blog

Company

  • About
  • Privacy Notice

© Seam Labs, Inc. All rights reserved.

On this page

Was this helpful?

Edit on GitHub
  1. API Reference
  2. Devices

Get a Device

Get a specified device

PreviousList Device ProvidersNextUpdate a Device

Last updated 6 months ago

Was this helpful?

Returns a specified .

Request

Specify the desired 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

pprint(seam.devices.get("30fd243b-3054-4384-a713-5487076a3826"))
# Use GET or POST.
curl -X 'GET' \
  'https://connect.getseam.com/devices/get' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer ${API_KEY}' \
  -H 'Content-Type: application/json' \
  -d '{
  "device_id": "30fd243b-3054-4384-a713-5487076a3826"
}'
console.log(await seam.devices.get({device_id: "30fd243b-3054-4384-a713-5487076a3826"}))
puts client.devices.get(device_id: "30fd243b-3054-4384-a713-5487076a3826").inspect
Device device = seam.Devices.Get("30fd243b-3054-4384-a713-5487076a3826");
Console.WriteLine(device);
Device device = seam.devices()
      .get(DevicesGetRequest.builder()
              .deviceId("30fd243b-3054-4384-a713-5487076a3826")
              .build());
System.out.println(device);

Response

This response also includes a Boolean ok status indicator.

Sample Response

Device(device_id='30fd243b-3054-4384-a713-5487076a3826',
       device_type='august_lock',
       location={'location_name': 'My House',
                 'timezone': 'America/Los_Angeles'},
       properties={'august_metadata': {'has_keypad': True,
                                       'house_id': 'house-1',
                                       'house_name': 'My House',
                                       'keypad_battery_level': 'Not Available',
                                       'lock_id': 'lock-2',
                                       'lock_name': 'BACK DOOR'},
                   'battery': {'level': 0.9999532347993827, 'status': 'full'},
                   'battery_level': 0.9999532347993827,
                   'code_constraints': [],
                   'door_open': False,
                   'has_native_entry_events': True,
                   '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',
                   'locked': True,
                   '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': 'BACK DOOR',
                   'offline_access_codes_enabled': False,
                   'online': True,
                   'online_access_codes_enabled': True,
                   'serial_number': '00000004-992d-45a0-bea1-9128fdcd8d12',
                   'supported_code_lengths': [4, 5, 6, 7, 8],
                   'supports_accessory_keypad': True,
                   'supports_backup_access_code_pool': True,
                   'supports_offline_access_codes': False},
       capabilities_supported=['access_code', 'lock'],
       errors=[],
       warnings=[],
       custom_metadata={'internal_account_id': 'user-1'},
       connected_account_id='f72442d2-2c16-4e3f-9882-6bff21828b1b',
       workspace_id='398d80b7-3f96-47c2-b85a-6f8ba21d07be',
       created_at='2023-10-28T09:13:08.465Z',
       is_managed=True)
{
  "device": {
    "device_id": "30fd243b-3054-4384-a713-5487076a3826",
    "device_type": "august_lock",
    "capabilities_supported": [
      "access_code",
      "lock"
    ],
    "properties": {
      "locked": true,
      "online": true,
      "door_open": false,
      "manufacturer": "august",
      "battery_level": 0.9999532347993827,
      "serial_number": "00000004-992d-45a0-bea1-9128fdcd8d12",
      "august_metadata": {
        "lock_id": "lock-2",
        "house_id": "house-1",
        "lock_name": "BACK DOOR",
        "has_keypad": true,
        "house_name": "My House",
        "keypad_battery_level": "Not Available"
      },
      "supported_code_lengths": [
        4,
        5,
        6,
        7,
        8
      ],
      "has_native_entry_events": true,
      "supports_accessory_keypad": true,
      "online_access_codes_enabled": true,
      "offline_access_codes_enabled": false,
      "supports_offline_access_codes": false,
      "name": "BACK DOOR",
      "model": {
        "display_name": "Lock",
        "manufacturer_display_name": "August",
        "accessory_keypad_supported": true,
        "offline_access_codes_supported": false,
        "online_access_codes_supported": true
      },
      "battery": {
        "level": 0.9999532347993827,
        "status": "full"
      },
      "image_url": "https://connect.getseam.com/assets/images/devices/august_wifi-smart-lock-3rd-gen_silver_front.png",
      "image_alt_text": "August Wifi Smart Lock 3rd Gen, Silver, Front",
      "code_constraints": [],
      "supports_backup_access_code_pool": true
    },
    "location": {
      "timezone": "America/Los_Angeles",
      "location_name": "My House"
    },
    "connected_account_id": "f72442d2-2c16-4e3f-9882-6bff21828b1b",
    "workspace_id": "398d80b7-3f96-47c2-b85a-6f8ba21d07be",
    "created_at": "2023-10-28T09:13:08.465Z",
    "errors": [],
    "warnings": [],
    "custom_metadata": {
        "internal_account_id": "user-1"
    },
    "is_managed": true
  },
  "ok": true
}
{
  device_id: '30fd243b-3054-4384-a713-5487076a3826',
  device_type: 'august_lock',
  capabilities_supported: [ 'access_code', 'lock' ],
  properties: {
    locked: true,
    online: true,
    door_open: false,
    manufacturer: 'august',
    battery_level: 0.9999532347993827,
    serial_number: '00000004-992d-45a0-bea1-9128fdcd8d12',
    august_metadata: {
      lock_id: 'lock-2',
      house_id: 'house-1',
      lock_name: 'BACK DOOR',
      has_keypad: true,
      house_name: 'My House',
      keypad_battery_level: 'Not Available'
    },
    supported_code_lengths: [ 4, 5, 6, 7, 8 ],
    has_native_entry_events: true,
    supports_accessory_keypad: true,
    online_access_codes_enabled: true,
    offline_access_codes_enabled: false,
    supports_offline_access_codes: false,
    name: 'BACK DOOR',
    model: {
      display_name: 'Lock',
      manufacturer_display_name: 'August',
      accessory_keypad_supported: true,
      offline_access_codes_supported: false,
      online_access_codes_supported: true
    },
    battery: { level: 0.9999532347993827, status: 'full' },
    image_url: 'https://connect.getseam.com/assets/images/devices/august_wifi-smart-lock-3rd-gen_silver_front.png',
    image_alt_text: 'August Wifi Smart Lock 3rd Gen, Silver, Front',
    code_constraints: [],
    supports_backup_access_code_pool: true
  },
  location: { timezone: 'America/Los_Angeles', location_name: 'My House' },
  connected_account_id: 'f72442d2-2c16-4e3f-9882-6bff21828b1b',
  workspace_id: '398d80b7-3f96-47c2-b85a-6f8ba21d07be',
  created_at: '2023-10-28T09:13:08.465Z',
  errors: [],
  warnings: [],
  custom_metadata: {'internal_account_id': 'user-1'},
  is_managed: true
}
<Seam::Device:0x00438
  device_id="30fd243b-3054-4384-a713-5487076a3826"
  device_type="august_lock"
  capabilities_supported=["access_code", "lock"]
  properties={"locked"=>true, "online"=>true, "door_open"=>false, "manufacturer"=>"august", "battery_level"=>0.9999532347993827, "serial_number"=>"00000004-992d-45a0-bea1-9128fdcd8d12", "august_metadata"=>{"lock_id"=>"lock-2", "house_id"=>"house-1", "lock_name"=>"BACK DOOR", "has_keypad"=>true, "house_name"=>"My House", "keypad_battery_level"=>"Not Available"}, "supported_code_lengths"=>[4, 5, 6, 7, 8], "has_native_entry_events"=>true, "supports_accessory_keypad"=>true, "online_access_codes_enabled"=>true, "offline_access_codes_enabled"=>false, "supports_offline_access_codes"=>false, "name"=>"BACK DOOR", "model"=>{"display_name"=>"Lock", "manufacturer_display_name"=>"August", "accessory_keypad_supported"=>true, "offline_access_codes_supported"=>false, "online_access_codes_supported"=>true}, "battery"=>{"level"=>0.9999532347993827, "status"=>"full"}, "image_url"=>"https://connect.getseam.com/assets/images/devices/august_wifi-smart-lock-3rd-gen_silver_front.png", "image_alt_text"=>"August Wifi Smart Lock 3rd Gen, Silver, Front", "code_constraints"=>[], "supports_backup_access_code_pool"=>true}
  connected_account_id="f72442d2-2c16-4e3f-9882-6bff21828b1b"
  workspace_id="398d80b7-3f96-47c2-b85a-6f8ba21d07be"
  created_at=2023-10-28 09:13:08.465 UTC
  errors=[]
  warnings=[]
  custom_metadata={"internal_account_id"=>"user-1"}
  is_managed=true>
{
  "device_id": "30fd243b-3054-4384-a713-5487076a3826",
  "device_type": "august_lock",
  "capabilities_supported": [
    "access_code",
    "lock"
  ],
  "properties": {
    "online": true,
    "name": "BACK DOOR",
    "model": {
      "display_name": "Lock",
      "manufacturer_display_name": "August",
      "offline_access_codes_supported": false,
      "accessory_keypad_supported": true
    },
    "battery_level": 0.9999532,
    "battery": {
      "level": 0.9999532,
      "status": "full"
    },
    "manufacturer": "august",
    "image_url": "https://connect.getseam.com/assets/images/devices/august_wifi-smart-lock-3rd-gen_silver_front.png",
    "image_alt_text": "August Wifi Smart Lock 3rd Gen, Silver, Front",
    "serial_number": "00000004-992d-45a0-bea1-9128fdcd8d12",
    "online_access_codes_enabled": true,
    "offline_access_codes_enabled": false,
    "supports_accessory_keypad": true,
    "supports_offline_access_codes": false,
    "august_metadata": {
      "lock_id": "lock-2",
      "lock_name": "BACK DOOR",
      "house_name": "My House",
      "has_keypad": true,
      "keypad_battery_level": "Not Available",
      "house_id": "house-1"
    },
    "code_constraints": [],
    "supported_code_lengths": [
      4.0,
      5.0,
      6.0,
      7.0,
      8.0
    ],
    "supports_backup_access_code_pool": true,
    "has_native_entry_events": true,
    "locked": true,
    "door_open": false
  },
  "location": {
    "location_name": "My House",
    "timezone": "America/Los_Angeles"
  },
  "connected_account_id": "f72442d2-2c16-4e3f-9882-6bff21828b1b",
  "workspace_id": "398d80b7-3f96-47c2-b85a-6f8ba21d07be",
  "errors": [],
  "warnings": [],
  "custom_metadata": {
    "internal_account_id": "user-1"
  },
  "created_at": "2023-10-28T09:13:08.465Z",
  "is_managed": true
}
{
  "device_id" : "30fd243b-3054-4384-a713-5487076a3826",
  "device_type" : "august_lock",
  "capabilities_supported" : [ "access_code", "lock" ],
  "properties" : {
    "online" : true,
    "name" : "BACK DOOR",
    "model" : {
      "display_name" : "Lock",
      "online_access_codes_supported" : true,
      "accessory_keypad_supported" : true,
      "offline_access_codes_supported" : false,
      "manufacturer_display_name" : "August"
    },
    "august_metadata" : {
      "lock_id" : "lock-2",
      "lock_name" : "BACK DOOR",
      "house_name" : "My House",
      "house_id" : "house-1",
      "has_keypad" : true,
      "keypad_battery_level" : "Not Available"
    },
    "offline_access_codes_enabled" : false,
    "battery_level" : 0.9999532347993827,
    "image_url" : "https://connect.getseam.com/assets/images/devices/august_wifi-smart-lock-3rd-gen_silver_front.png",
    "supports_accessory_keypad" : true,
    "serial_number" : "00000004-992d-45a0-bea1-9128fdcd8d12",
    "battery" : {
      "level" : 0.9999532347993827,
      "status" : "full"
    },
    "code_constraints" : [ ],
    "has_native_entry_events" : true,
    "image_alt_text" : "August Wifi Smart Lock 3rd Gen, Silver, Front",
    "manufacturer" : "august",
    "door_open" : false,
    "online_access_codes_enabled" : true,
    "supported_code_lengths" : [ 4, 5, 6, 7, 8 ],
    "locked" : true,
    "supports_offline_access_codes" : false,
    "supports_backup_access_code_pool" : true
  },
  "location" : {
    "timezone" : "America/Los_Angeles",
    "location_name" : "My House"
  },
  "connected_account_id" : "f72442d2-2c16-4e3f-9882-6bff21828b1b",
  "workspace_id" : "398d80b7-3f96-47c2-b85a-6f8ba21d07be",
  "custom_metadata": {
    "internal_account_id": "user-1"
  },
  "created_at" : "2023-10-28T09:13:08.465Z",
  "is_managed" : true
}

Returns a device that contains the set of applicable device properties. For details, see .

📋
Devices
device
  • POST/devices/get
  • Request
  • Request Body Parameters
  • Sample Request
  • Response
  • Sample Response

/devices/get

post

Returns a specified device.

You must specify either device_id or name.

Authorizations
Body
device_idstring · uuidOptional

ID of the device that you want to get.

namestringOptional

Name of the device that you want to get.

Responses
200
OK
application/json
400
Bad Request
401
Unauthorized
post
POST /devices/get HTTP/1.1
Host: connect.getseam.com
Authorization: Bearer Client Session 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",
    "nickname": "text",
    "display_name": "text",
    "capabilities_supported": [
      "access_code"
    ],
    "properties": {
      "online": true,
      "accessory_keypad": {
        "is_connected": true,
        "battery": {
          "level": 1
        }
      },
      "appearance": {
        "name": "text"
      },
      "model": {
        "can_connect_accessory_keypad": true,
        "display_name": "text",
        "manufacturer_display_name": "text",
        "has_built_in_keypad": true,
        "offline_access_codes_supported": true,
        "online_access_codes_supported": true
      },
      "has_direct_power": true,
      "battery_level": 1,
      "battery": {
        "level": 1,
        "status": "critical"
      },
      "manufacturer": "text",
      "image_url": "https://example.com",
      "image_alt_text": "text",
      "serial_number": "text",
      "online_access_codes_enabled": true,
      "offline_access_codes_enabled": true,
      "noise_level_decibels": 1,
      "currently_triggering_noise_threshold_ids": [
        "text"
      ],
      "assa_abloy_credential_service_metadata": {
        "has_active_endpoint": true,
        "endpoints": [
          {
            "endpoint_id": "text",
            "is_active": true
          }
        ]
      },
      "salto_space_credential_service_metadata": {
        "has_active_phone": true
      },
      "august_metadata": {
        "lock_id": "text",
        "lock_name": "text",
        "house_name": "text",
        "has_keypad": true,
        "keypad_battery_level": "text",
        "model": "text",
        "house_id": "text"
      },
      "avigilon_alta_metadata": {
        "entry_name": "text",
        "org_name": "text",
        "zone_id": 1,
        "zone_name": "text",
        "site_id": 1,
        "site_name": "text",
        "entry_relays_total_count": 1
      },
      "schlage_metadata": {
        "device_id": "text",
        "device_name": "text",
        "model": "text"
      },
      "smartthings_metadata": {
        "device_id": "text",
        "device_name": "text",
        "model": "text",
        "location_id": "text"
      },
      "lockly_metadata": {
        "device_id": "text",
        "device_name": "text",
        "model": "text"
      },
      "nuki_metadata": {
        "device_id": "text",
        "device_name": "text",
        "keypad_battery_critical": true,
        "keypad_paired": true,
        "keypad_2_paired": true
      },
      "kwikset_metadata": {
        "device_id": "text",
        "device_name": "text",
        "model_number": "text"
      },
      "salto_metadata": {
        "lock_id": "text",
        "customer_reference": "text",
        "lock_type": "text",
        "battery_level": "text",
        "locked_state": "text",
        "model": "text"
      },
      "salto_ks_metadata": {
        "lock_id": "text",
        "customer_reference": "text",
        "lock_type": "text",
        "battery_level": "text",
        "locked_state": "text",
        "model": "text"
      },
      "genie_metadata": {
        "device_name": "text",
        "door_name": "text"
      },
      "brivo_metadata": {
        "device_name": "text"
      },
      "igloo_metadata": {
        "device_id": "text",
        "bridge_id": "text",
        "model": "text"
      },
      "noiseaware_metadata": {
        "device_model": "indoor",
        "noise_level_nrs": 1,
        "noise_level_decibel": 1,
        "device_name": "text",
        "device_id": "text"
      },
      "minut_metadata": {
        "device_id": "text",
        "device_name": "text",
        "latest_sensor_values": {
          "temperature": {
            "time": "text",
            "value": 1
          },
          "sound": {
            "time": "text",
            "value": 1
          },
          "humidity": {
            "time": "text",
            "value": 1
          },
          "pressure": {
            "time": "text",
            "value": 1
          },
          "accelerometer_z": {
            "time": "text",
            "value": 1
          }
        }
      },
      "four_suites_metadata": {
        "device_id": 1,
        "device_name": "text",
        "reclose_delay_in_seconds": 1
      },
      "two_n_metadata": {
        "device_id": 1,
        "device_name": "text"
      },
      "controlbyweb_metadata": {
        "device_id": "text",
        "device_name": "text",
        "relay_name": "text"
      },
      "ttlock_metadata": {
        "lock_id": 1,
        "lock_alias": "text",
        "feature_value": "text",
        "features": {
          "passcode": true,
          "passcode_management": true,
          "unlock_via_gateway": true,
          "lock_command": true,
          "incomplete_keyboard_passcode": true,
          "wifi": true
        },
        "has_gateway": true,
        "wireless_keypads": [
          {
            "wireless_keypad_id": 1,
            "wireless_keypad_name": "text"
          }
        ]
      },
      "seam_bridge_metadata": {
        "unlock_method": "bridge",
        "device_num": 1,
        "name": "text"
      },
      "igloohome_metadata": {
        "device_id": "text",
        "device_name": "text",
        "bridge_id": "text",
        "bridge_name": "text",
        "keypad_id": "text"
      },
      "nest_metadata": {
        "nest_device_id": "text",
        "device_name": "text",
        "device_custom_name": "text",
        "display_name": "text"
      },
      "ecobee_metadata": {
        "ecobee_device_id": "text",
        "device_name": "text"
      },
      "honeywell_resideo_metadata": {
        "honeywell_resideo_device_id": "text",
        "device_name": "text"
      },
      "hubitat_metadata": {
        "device_id": "text",
        "device_name": "text",
        "device_label": "text"
      },
      "dormakaba_oracode_metadata": {
        "door_id": 1,
        "door_name": "text",
        "device_id": 1,
        "door_is_wireless": true,
        "site_id": 1,
        "site_name": "text",
        "iana_timezone": "text",
        "predefined_time_slots": [
          {
            "name": "text",
            "prefix": 1,
            "check_in_time": "text",
            "check_out_time": "text",
            "is_24_hour": true,
            "is_biweekly_mode": true,
            "is_one_shot": true,
            "is_master": true,
            "ext_dormakaba_oracode_user_level_prefix": 1,
            "dormakaba_oracode_user_level_id": "123e4567-e89b-12d3-a456-426614174000"
          }
        ]
      },
      "wyze_metadata": {
        "device_id": "text",
        "device_name": "text",
        "product_name": "text",
        "product_type": "text",
        "product_model": "text",
        "device_info_model": "text",
        "keypad_uuid": "text",
        "locker_status_hardlock": 1
      },
      "tedee_metadata": {
        "device_id": 1,
        "serial_number": "text",
        "device_name": "text",
        "device_model": "text",
        "bridge_id": 1,
        "bridge_name": "text",
        "keypad_id": 1
      },
      "visionline_metadata": {
        "encoder_id": "text"
      },
      "akiles_metadata": {
        "gadget_name": "text",
        "gadget_id": "text",
        "product_name": "text",
        "_member_group_id": "text"
      },
      "assa_abloy_vostio_metadata": {
        "encoder_name": "text"
      },
      "tado_metadata": {
        "serial_no": "text",
        "device_type": "text"
      },
      "sensi_metadata": {
        "device_id": "text",
        "device_name": "text",
        "product_type": "text"
      },
      "_experimental_supported_code_from_access_codes_lengths": [
        1
      ],
      "code_constraints": [
        {
          "constraint_type": "no_zeros"
        }
      ],
      "supported_code_lengths": [
        1
      ],
      "max_active_codes_supported": 1,
      "supports_backup_access_code_pool": true,
      "has_native_entry_events": true,
      "locked": true,
      "keypad_battery": {
        "level": 1
      },
      "door_open": true,
      "temperature_fahrenheit": 1,
      "temperature_celsius": 1,
      "relative_humidity": 1,
      "available_hvac_mode_settings": [
        "off"
      ],
      "available_fan_mode_settings": [
        "auto"
      ],
      "is_heating": true,
      "is_cooling": true,
      "is_fan_running": true,
      "is_temporary_manual_override_active": true,
      "current_climate_setting": {
        "climate_preset_key": "text",
        "can_edit": true,
        "can_delete": true,
        "can_program": true,
        "name": "text",
        "display_name": "text",
        "fan_mode_setting": "auto",
        "hvac_mode_setting": "off",
        "cooling_set_point_celsius": 1,
        "heating_set_point_celsius": 1,
        "cooling_set_point_fahrenheit": 1,
        "heating_set_point_fahrenheit": 1
      },
      "available_climate_presets": [
        {
          "climate_preset_key": "text",
          "can_edit": true,
          "can_delete": true,
          "can_program": true,
          "name": "text",
          "display_name": "text",
          "fan_mode_setting": "auto",
          "hvac_mode_setting": "off",
          "cooling_set_point_celsius": 1,
          "heating_set_point_celsius": 1,
          "cooling_set_point_fahrenheit": 1,
          "heating_set_point_fahrenheit": 1
        }
      ],
      "fallback_climate_preset_key": "text",
      "active_thermostat_schedule": {
        "thermostat_schedule_id": "123e4567-e89b-12d3-a456-426614174000",
        "device_id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "climate_preset_key": "text",
        "max_override_period_minutes": 1,
        "starts_at": "2025-05-28T20:08:17.490Z",
        "is_override_allowed": true,
        "ends_at": "2025-05-28T20:08:17.490Z",
        "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
        "created_at": "2025-05-28T20:08:17.490Z",
        "errors": [
          {
            "error_code": "text",
            "message": "text"
          }
        ]
      },
      "thermostat_daily_programs": [
        {
          "thermostat_daily_program_id": "123e4567-e89b-12d3-a456-426614174000",
          "device_id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text",
          "periods": [
            {
              "starts_at_time": "text",
              "climate_preset_key": "text"
            }
          ],
          "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
          "created_at": "2025-05-28T20:08:17.490Z"
        }
      ],
      "thermostat_weekly_program": {
        "monday_program_id": "123e4567-e89b-12d3-a456-426614174000",
        "tuesday_program_id": "123e4567-e89b-12d3-a456-426614174000",
        "wednesday_program_id": "123e4567-e89b-12d3-a456-426614174000",
        "thursday_program_id": "123e4567-e89b-12d3-a456-426614174000",
        "friday_program_id": "123e4567-e89b-12d3-a456-426614174000",
        "saturday_program_id": "123e4567-e89b-12d3-a456-426614174000",
        "sunday_program_id": "123e4567-e89b-12d3-a456-426614174000",
        "created_at": "2025-05-28T20:08:17.490Z"
      },
      "min_cooling_set_point_celsius": 1,
      "min_cooling_set_point_fahrenheit": 1,
      "max_cooling_set_point_celsius": 1,
      "max_cooling_set_point_fahrenheit": 1,
      "min_heating_set_point_celsius": 1,
      "min_heating_set_point_fahrenheit": 1,
      "max_heating_set_point_celsius": 1,
      "max_heating_set_point_fahrenheit": 1,
      "min_heating_cooling_delta_celsius": 1,
      "min_heating_cooling_delta_fahrenheit": 1,
      "temperature_threshold": {
        "lower_limit_celsius": 1,
        "lower_limit_fahrenheit": 1,
        "upper_limit_celsius": 1,
        "upper_limit_fahrenheit": 1
      }
    },
    "location": {
      "location_name": "text",
      "timezone": "text"
    },
    "connected_account_id": "123e4567-e89b-12d3-a456-426614174000",
    "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
    "errors": [
      {
        "message": "text",
        "is_device_error": false,
        "created_at": "2025-05-28T20:08:17.490Z",
        "error_code": "account_disconnected",
        "is_connected_account_error": true
      }
    ],
    "warnings": [
      {
        "message": "text",
        "created_at": "2025-05-28T20:08:17.490Z",
        "warning_code": "partial_backup_access_code_pool"
      }
    ],
    "created_at": "2025-05-28T20:08:17.490Z",
    "is_managed": true,
    "custom_metadata": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "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
  },
  "ok": true
}