Devices

Get the Status of a Capability

Get the current status of a Device component's capability.

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}/capabilities/{capabilityId}/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/capabilities/:capabilityId/status/get.ts
A function with typed inputs. Its response is checked against the schema.

Successful return of current status of the attributes of a device component's capability

CapabilityStatus required

A map of attribute name to attribute state.

{
  "switch": {
    "value": "on"
  }
}

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