Devices

Get the Status of a Device Component

Get the status of all attributes of a specified component.

The results may be filtered if the requester only has permission to view a subset of the component's 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.

get/devices/{deviceId}/components/{componentId}/status

Request

Base URL
https://api.smartthings.com/v1
Auth
OAuth 2
Implicithttps://auth-global.api.smartthings.com
Scopesr:devices:*
TypeScript
https://skmtc.dev/smartthings/apis/smartthings-api/docs/devices/:deviceId/components/:componentId/status/get.ts
A function with typed inputs. Its response is checked against the schema.

Successful return current status of device component's attributes.

ComponentStatus required

A map of capabilityId to capability status.

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

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