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
- Base URLhttps://api.smartthings.com/v1
- AuthOAuth 2Implicithttps://auth-global.api.smartthings.comScopesr:devices:*
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Response
successful return of current status of device attributes
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.