Skip to main content

Get a device property time interval

Request

Returns a specific device property time interval for a device.

Security
ApiKey(Required scopes: devices.list)
Path
nameOrIdstringrequired

Device name or ID. Device names must be URI-encoded if they contain non-URI-safe characters. If a device is named with another device's ID, the device with the matching name will be returned.

idstringrequired

Property Time Interval ID.

Query
projectIdstring

The project ID that the device belongs to. Required for multi-project orgs.

Payload
// No request payload

Responses

Property time interval

Bodyapplication/json
idstringrequired

ID of the property time interval.

deviceIdstringrequired

ID of the associated device.

keystringrequired

Key of the property.

valuestring or number or boolean or Array of stringsrequired
One of:

Value of the property.

string
startstring, (date-time)required

Inclusive start time this value was in effect.

endstring, (date-time)

Exclusive end time this value was in effect. When absent the value is still in effect.

Response
{ "id": "string", "deviceId": "string", "key": "string", "value": "string", "start": "2019-08-24T14:15:22Z", "end": "2019-08-24T14:15:22Z" }