Devices

Get the Full Status of a Device

Get the current status of all of a Device component's attributes.

The results may be filtered if the requester only has permission to view a subset of the Device's components or capabilities.

If the OAuth token used in this API call is for a SmartApp that created the Device, it implicitly has permission for this API.

DEPRECATION NOTICE: healthState is no longer included in response.

get/devices/{deviceId}/status

Request

Response

successful return of current status of device attributes

componentsobject

A map of componentId to component status.

Example response

{
  "components": {
    "main": {
      "switch": {
        "switch": {
          "value": "on"
        }
      },
      "switchLevel": {
        "level": {
          "value": 90
        }
      }
    }
  }
}

Changes

No recorded changes to this operation across all 8 revisions of this API.