Shutoff Valve
Method
Description
Method
Description
PUT
Open or Close Valve
https://api.honeywell.com/v2/devices/shutoffvalve/{deviceId}/control
Open or close an L5 valve manually
Homeywell Home T-Series devices also have the capability of a 7-day schedule as well as geofencing. When sending a setpoint change request you have a few options:
Request body example:
{
"state": "open"
}
Data Definitions
Field Name/Location
Data Type
Definition
state
String
"open" or "close"
GET
Get Shutoff Valve
https://api.honeywell.com/v2/devices/shutoffvalve/{deviceId}
Get data for a specific shutoff valve
Response Model Example Data Definitions
{
"name": "Basement",
"deviceMac": "48A2E691D4DA",
"deviceID": "4579041",
"deviceClass": "ShutoffValve",
"dataSyncInfo": {
"state": "Completed",
"transactionId": "qPQBUIxArASeqs3Z"
},
"deviceRegistrationDate": "2022-10-19T16:39:37.997",
"isAlive": true,
"lastCheckin": "2022-12-13T20:17:09.559+00:00",
"actuatorValve": {
"commandSource": "app",
"runningTime": 7619,
"valveStatus": "Close",
"motorCycles": 14,
"motorCurrentAverage": 91,
"motorCurrentMax": 0,
"deviceTemperature": 86.6,
"lastAntiScaleTime": "2022-12-01T07:00:00.000+00:00",
"leakStatus": "Na",
"timeValveChanged": "2022-12-13T20:17:09.559+00:00"
},
"daylightSavingsInfo": {
"isDaylightSaving": false,
"nextOffsetChange": "2023-03-12T08:00:00.000+00:00"
},
"maintenance": {
"antiScaleSettings": "OncePerMonth",
"antiScaleDOWSettings": "Sunday",
"antiScaleDOMSettings": 1,
"antiScaleTimeSettings": "07:00"
}
}
Field Name/Location
Data Type
Definition
name
String
Device name
deviceMac
String
Device MACID
deviceID
String
DeviceID
deviceClass
String
"ShutoffValve"
dataSyncInfo
Object
dataSyncInfo.state
Enum
NotStarted, Initiated, Completed, Failed
dataSyncInfo.transactionId
String
Internal reference ID for the DataSync operation
deviceRegistrationDate
DateTime
Timestamp of the device registration
isAlive
Boolean
Is the device online or offline
lastCheckin
DateTime
Last time data received from device
actuatorValve
Object
Values specific to the valve operation
actuatorValve.commandSource
Enum
Reason for last valve open/close. Possible values: app, wldFreeze, wldLeak, manual, buildInLeak, maintenance
actuatorValve.runningTime
Integer
Operation time
actuatorValve.valveStatus
Enum
Current known valve state. Possible Values: unknown, open, close, notOpen, notClose, opening, closing, antiScaleOpening, antiScaleClosing
actuatorValve.motorCycles
Integer
Count of motor operations
actuatorValve.motorCurrentAverage
Integer
actuatorValve.motorCurrentMax
Integer
actuatorValve.deviceTemperature
Decimal
Current temperature of device in Fahrenheit units
actuatorValve.lastAntiScaleTime
DateTime
Last time of anti-scale operation
actuatorValve.leakStatus
Enum
Current state of leak detection. Possible Values: ok, leak, na, err
actuatorValve.timeValveChanged
DateTime
Time of last valve change
daylightSavingsInfo
Object
Daylight savings time config info
daylightSavingsInfo.isDaylightSaving
Boolean
If device is currently using DST or not
daylightSavingsInfo.nextOffsetChange
DateTime
Next scheduled DST changeover
maintenance
Object
Maintenance settings
maintenance.antiScaleSettings
Enum
Current anti-scale cycle: OncePerWeek, OncePerTwoWeeks, OncePerMonth, OncePerTwoMonths, Disabled
maintenance.antiScaleDOWSettings
Enum
If weekly anti-scale is enabled, day of the week used: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
maintenance.antiScaleDOMSettings
Int
If monthly anti-scale is used, day of the month.
maintenance.antiScaleDOMSettings
String
Time for anti-scale in 24 hrs format
__PRESENT
Thermostat
Method
Description
Method
Description
PUT
Set Room Priority
https://api.honeywell.com/v2/devices/thermostats/{deviceId}/priority
Change the room priority settings for a T9/T10 thermostat.
Priority Types:
"PickARoom" - This will set the priority to the selected room(s)
"FollowMe" - This will set room priority based on motion/occupancy.
"WholeHouse" - This will use all rooms for priority.
Example body:
{
"currentPriority": {
"priorityType": "PickARoom",
"selectedRooms": [
0,
1
]
}
}
Data Definitions
Field Name/Location
Data Type
Definition
currentPriority.priorityType
String
Set the desired priority type ('PickARoom', 'FollowMe', 'WholeHouse')
currentPriority.selectedRooms
Array
Comma separated list of numbers of the rooms to use in the priority setting
GET
Get Room Priority
https://api.honeywell.com/v2/devices/thermostats/{deviceId}/priority
Get room priority for a device
This will GET priority settings for a thermostat.
Response Model Example Data Definitions
{
"deviceId": "B82CA0196B73",
"status": "TemporaryHold",
"currentPriority": {
"priorityType": "PickARoom",
"selectedRooms": [
2
],
"rooms": [
{
"id": 0,
"roomName": "Living Room",
"roomAvgTemp": 72.945,
"roomAvgHumidity": 31,
"overallMotion": false,
"accessories": [
{
"id": 0,
"type": "Thermostat",
"excludeTemp": false,
"excludeMotion": false,
"temperature": 73.672
}
]
},
{
"id": 1,
"roomName": "Guest Bedroom",
"roomAvgTemp": 72.93,
"roomAvgHumidity": 29,
"overallMotion": true,
"accessories": [
{
"id": 1,
"type": "IndoorAirSensor",
"excludeTemp": false,
"excludeMotion": false,
"temperature": 72.93
}
]
},
{
"id": 2,
"roomName": "Master Bedroom",
"roomAvgTemp": 73.672,
"roomAvgHumidity": 28,
"overallMotion": false,
"accessories": [
{
"id": 2,
"type": "IndoorAirSensor",
"excludeTemp": false,
"excludeMotion": true,
"temperature": 73.672
}
]
},
{
"id": 3,
"roomName": "Family Room",
"roomAvgTemp": 73.008,
"roomAvgHumidity": 28,
"overallMotion": true,
"accessories": [
{
"id": 3,
"type": "IndoorAirSensor",
"excludeTemp": false,
"excludeMotion": false,
"temperature": 73.008
}
]
}
]
}
}
Field Name/Location
Data Type
Definition
deviceId
String
Device ID of the main thermostat (T9/T10)
status
Enum
Status of priority settings ('TemporaryHold', 'PermanentHold', 'HoldUntil', 'NoHold', 'VacationHold')
currentPriority
Object
Current priority settings
currentPriority.priorityType
Enum
Current priority setting ('PickARoom', 'FollowMe', 'WholeHouse')
currentPriority.selectedRooms
Array
List of rooms in the current priority setting
currentPriority.rooms
Array
Array of room objects
room.id
Integer
ID of the room
room.roomName
String
User defined room name
room.roomAvgTemp
Number
Average temperature of the room
room.roomAvgHumidity
Number
Average humidity of the room
room.overallMotion
Boolean
Is motion detected in the room
room.accessories
Array
Array of accessories in the room
accessory.id
Integer
ID of the accessory
accessory.type
String
Type of the accessory ('IndoorAirSensor', 'Thermostat')
accessory.excludeTemp
Boolean
Exclude temperature readings
accessory.excludeMotion
Boolean
Exclude motion sensing
accessory.temperature
Number
Current temperature reading
GET
Get rooms in a group
https://api.honeywell.com/v2/devices/thermostats/{deviceId}/group/{groupId}/rooms
Get rooms for a group
This will GET rooms for a specific device and group.
Response Model Example Data Definitions
{
"deviceId": "LCC-B82CA0196B73",
"groupId": 0,
"rooms": [
{
"id": 0,
"name": "Living Room",
"type": "LivingSpace",
"avgTemperature": 72.766,
"avgHumidity": 24,
"accessories": [
{
"accessoryId": 0,
"accessoryAttribute": {
"type": "Thermostat",
"connectionMethod": "WI",
"name": "Thermostat",
"model": "RCHT9610WFW2004",
"serialNumber": "123456789012",
"softwareRevision": "1.1.10.0",
"hardwareRevision": "FLYCATCH_TS-0001"
},
"accessoryValue": {
"coolSetpoint": 0,
"heatSetpoint": 0,
"indoorHumidity": 21,
"indoorTemperature": 72.695,
"motionDet": false,
"occupancyDet": false,
"excludeTemp": false,
"excludeMotion": false,
"pressure": 0,
"occupancyTimeout": 0,
"status": "Ok",
"batteryStatus": "Ok",
"rssiAverage": -49
}
}
]
},
{
"id": 1,
"name": "Guest Bedroom",
"type": "Bedroom",
"avgTemperature": 73.008,
"avgHumidity": 22,
"accessories": [
{
"accessoryId": 1,
"accessoryAttribute": {
"type": "IndoorAirSensor",
"connectionMethod": "RL",
"name": "Guest Bedroom",
"model": "4352",
"serialNumber": "",
"softwareRevision": "1.0.3.0",
"hardwareRevision": "48.49.45.65"
},
"accessoryValue": {
"coolSetpoint": 0,
"heatSetpoint": 0,
"indoorHumidity": 22,
"indoorTemperature": 72.969,
"motionDet": true,
"occupancyDet": false,
"excludeTemp": false,
"excludeMotion": false,
"pressure": 0,
"occupancySensitivity": "Medium",
"occupancyTimeout": 0,
"status": "Ok",
"batteryStatus": "Ok",
"rssiAverage": -44
}
}
]
},
{
"id": 2,
"name": "Master Bedroom",
"type": "Bedroom",
"avgTemperature": 73.039,
"avgHumidity": 22,
"accessories": [
{
"accessoryId": 2,
"accessoryAttribute": {
"type": "IndoorAirSensor",
"connectionMethod": "RL",
"name": "Master Bedroom",
"model": "4352",
"serialNumber": "",
"softwareRevision": "1.0.3.0",
"hardwareRevision": "48.49.45.65"
},
"accessoryValue": {
"coolSetpoint": 0,
"heatSetpoint": 0,
"indoorHumidity": 22,
"indoorTemperature": 73.008,
"motionDet": true,
"occupancyDet": false,
"excludeTemp": false,
"excludeMotion": false,
"pressure": 0,
"occupancySensitivity": "Medium",
"occupancyTimeout": 0,
"status": "Ok",
"batteryStatus": "Ok",
"rssiAverage": -50
}
}
]
},
{
"id": 3,
"name": "Family Room",
"type": "LivingSpace",
"avgTemperature": 72.828,
"avgHumidity": 21,
"accessories": [
{
"accessoryId": 3,
"accessoryAttribute": {
"type": "IndoorAirSensor",
"connectionMethod": "RL",
"name": "Family Room",
"model": "4352",
"serialNumber": "",
"softwareRevision": "1.0.3.0",
"hardwareRevision": "48.49.45.65"
},
"accessoryValue": {
"coolSetpoint": 0,
"heatSetpoint": 0,
"indoorHumidity": 21,
"indoorTemperature": 72.789,
"motionDet": true,
"occupancyDet": false,
"excludeTemp": false,
"excludeMotion": false,
"pressure": 0,
"occupancySensitivity": "Medium",
"occupancyTimeout": 0,
"status": "Ok",
"batteryStatus": "Low",
"rssiAverage": -35
}
}
]
}
]
}
Field Name/Location
Data Type
Definition
deviceId
String
Device ID of the main thermostat (T9/T10)
groupId
Number
Group ID
rooms
Array
Array of objects for each room in the group
room.id
Integer
ID of the room in the group
room.name
String
User defined name of the room
room.type
String
Type of room
room.avgTemperature
Number
Average temperature of all sensors in the room
room.avgHumidity
Number
Average humidity of all sensors in the room
room.accessories
Array
Array of accessory (sensor) objects
accessory.accessoryId
Integer
ID of the acessory
accessory.accessoryAttribute
Object
Accessory attributes
accessoryAttribute.type
String
Type of accessory
accessoryAttribute.connectionMethod
String
Method of communication between the accessory and base station
accessoryAttribute.name
String
Name of the accessory
accessoryAttribute.model
String
Model # of the accessory
accessoryAttribute.serialNumber
String
Serial number of the accessory
accessoryAttribute.softwareRevision
String
accessoryAttribute.hardwareRevision
String
accessory.accessoryValue
Object
Object of accessory values (data)
accessoryValue.coolSetpoint
Number
Cool setpoint of the accessory
accessoryValue.heatSetpoint
Number
Cool setpoint of the accessory
accessoryValue.indoorHumidity
Number
Humidity reading at the accessory
accessoryValue.indoorTemperature
Number
Temperature reading at the accessory
accessoryValue.motionDet
Boolean
Is motion detected?
accessoryValue.occupancyDet
Boolean
Is the room occupied?
accessoryValue.excludeTemp
Boolean
Exclude temperature reading from operation
accessoryValue.excludeMotion
Boolean
Exclude motion sensor reading from operation
accessoryValue.pressure
Number
accessoryValue.occupancySensitivity
String
Sensitivity level of occupancy sensor
accessoryValue.occupancyTimeout
Integer
Timeout of occupancy detected
accessoryValue.status
String
Status of accessory
accessoryValue.batteryStatus
String
Status of accessory battery
accessoryValue.rssiAverage
Number
Signal strength to the base
POST
Set Schedule
https://api.honeywell.com/v2/devices/schedule/{deviceId}
Set current schedule for a given DeviceID
T5/T6 can have 4 periods, T9/T10 can have up to 6.
Timed schedule should have all 7 days of a week and can not repeat a day again.
If "isCancelled" is 'true' the period wil not be set.
if "isCancelled" is 'False' the period is set with respective values
Request Model ExampleData DefinitionsExample Timed Schedule
{
"deviceID": "LCC-abcdef1234"
"scheduleType": "Timed",
"scheduleSubType": "NA",
"timedSchedule": {
"days": [
{
"day": "Monday",
"periods": [
{
"isCancelled": true,
"periodType": "Wake",
"periodName": "string",
"startTime": "string",
"heatSetPoint": 0,
"coolSetPoint": 0,
"fanSwitch": {
"position": "Auto",
"speed": 0
},
"priority": {
"priorityType": "WholeHouse",
"selectedRooms": [
0
]
},
"schedSysSwitch": "On"
}
]
}
]
}
}
Field Name/Location
Data Type
Definition
Required
deviceID
String
DeviceID associated to the schedule
Y
scheduleType
Enum
Schedule type, possible values: None,Geofenced,GeofencedWithSleep,Timed,Partner
Y
scheduleSubType
Enum
Secondary schedule type, "NA", "EMEA", "NONE"
N
timedSchedule
Object
Contains schedule settings
timedSchedule.days
Array
Contains schedule settings
timedSchedule.days.day
Enum
Day of the week 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', 'Sunday'
timedSchedule.days.periods
Object
Schedule periods for the given day
timedSchedule.days.periods.isCancelled
Boolean
True/false if the period is enabled for a given day
timedSchedule.days.periods.periodType
String
Period of the day (e.g, "Wake", "Away", "Home", "Sleep")
timedSchedule.days.periods.startTime
String
Time of the day the schedule period starts, in local time. Always 15 minute increments.
timedSchedule.days.periods.heatSetPoint
Decimal
Heating setpoint for the period
timedSchedule.days.periods.coolSetPoint
Decimal
Cooling setpoint for the period
timedSchedule.days.periods.fanSwitch
Object
Fan switch scheduling (T9/T10 only)
timedSchedule.days.periods.fanSwitch.position
Enum
Auto, On, Circulate, FollowSchedule
timedSchedule.days.periods.fanSwitch.speed
Number
Always 0
timedSchedule.days.periods.priority
Object
Sensor priority setting for scheduled period (T9/T10 Only)
timedSchedule.days.periods.priority.priorityType
Enum
WholeHouse, PickARoom,FollowMe
timedSchedule.days.periods.priority.selectedRooms
Array
Array of Numbers of Rooms to Prioritize (via Rooms/Groups API)
{
"deviceID": "LCC-{{MacID}}",
"scheduleSubType": "NA",
"scheduleType": "timed",
"timedSchedule": {
"days": [{
"day": "Monday",
"periods": [{
"coolSetPoint": 80,
"heatSetPoint": 70,
"isCancelled": true,
"periodType": "Wake",
"startTime": "06:00:00"
}, {
"coolSetPoint": 85,
"heatSetPoint": 62,
"isCancelled": true,
"periodType": "Away",
"startTime": "08:00:00"
}, {
"coolSetPoint": 78,
"heatSetPoint": 70,
"isCancelled": false,
"periodType": "Home",
"startTime": "18:00:00"
}, {
"coolSetPoint": 82,
"heatSetPoint": 62,
"isCancelled": false,
"periodType": "Sleep",
"startTime": "22:00:00"
}]
}, {
"day": "Tuesday",
"periods": [{
"coolSetPoint": 80,
"heatSetPoint": 70,
"isCancelled": false,
"periodType": "Wake",
"startTime": "06:00:00"
}, {
"coolSetPoint": 85,
"heatSetPoint": 62,
"isCancelled": false,
"periodType": "Away",
"startTime": "08:00:00"
}, {
"coolSetPoint": 78,
"heatSetPoint": 70,
"isCancelled": false,
"periodType": "Home",
"startTime": "18:00:00"
}, {
"coolSetPoint": 82,
"heatSetPoint": 62,
"isCancelled": false,
"periodType": "Sleep",
"startTime": "22:00:00"
}]
}, {
"day": "Wednesday",
"periods": [{
"coolSetPoint": 80,
"heatSetPoint": 70,
"isCancelled": false,
"periodType": "Wake",
"startTime": "06:00:00"
}, {
"coolSetPoint": 85,
"heatSetPoint": 62,
"isCancelled": false,
"periodType": "Away",
"startTime": "08:00:00"
}, {
"coolSetPoint": 78,
"heatSetPoint": 70,
"isCancelled": false,
"periodType": "Home",
"startTime": "18:00:00"
}, {
"coolSetPoint": 82,
"heatSetPoint": 62,
"isCancelled": false,
"periodType": "Sleep",
"startTime": "22:00:00"
}]
}, {
"day": "Thursday",
"periods": [{
"coolSetPoint": 80,
"heatSetPoint": 70,
"isCancelled": false,
"periodType": "Wake",
"startTime": "06:00:00"
}, {
"coolSetPoint": 85,
"heatSetPoint": 62,
"isCancelled": false,
"periodType": "Away",
"startTime": "08:00:00"
}, {
"coolSetPoint": 78,
"heatSetPoint": 70,
"isCancelled": false,
"periodType": "Home",
"startTime": "18:00:00"
}, {
"coolSetPoint": 82,
"heatSetPoint": 62,
"isCancelled": false,
"periodType": "Sleep",
"startTime": "22:00:00"
}]
}, {
"day": "Friday",
"periods": [{
"coolSetPoint": 80,
"heatSetPoint": 70,
"isCancelled": false,
"periodType": "Wake",
"startTime": "06:00:00"
}, {
"coolSetPoint": 85,
"heatSetPoint": 62,
"isCancelled": false,
"periodType": "Away",
"startTime": "08:00:00"
}, {
"coolSetPoint": 78,
"heatSetPoint": 70,
"isCancelled": false,
"periodType": "Home",
"startTime": "18:00:00"
}, {
"coolSetPoint": 82,
"heatSetPoint": 62,
"isCancelled": false,
"periodType": "Sleep",
"startTime": "22:00:00"
}]
}, {
"day": "Saturday",
"periods": [{
"coolSetPoint": 80,
"heatSetPoint": 70,
"isCancelled": false,
"periodType": "Wake",
"startTime": "06:00:00"
}, {
"coolSetPoint": 85,
"heatSetPoint": 62,
"isCancelled": false,
"periodType": "Away",
"startTime": "08:00:00"
}, {
"coolSetPoint": 78,
"heatSetPoint": 70,
"isCancelled": false,
"periodType": "Home",
"startTime": "18:00:00"
}, {
"coolSetPoint": 82,
"heatSetPoint": 62,
"isCancelled": false,
"periodType": "Sleep",
"startTime": "22:00:00"
}]
}, {
"day": "Sunday",
"periods": [{
"coolSetPoint": 80,
"heatSetPoint": 70,
"isCancelled": false,
"periodType": "Wake",
"startTime": "06:00:00"
}, {
"coolSetPoint": 85,
"heatSetPoint": 62,
"isCancelled": false,
"periodType": "Away",
"startTime": "08:00:00"
}, {
"coolSetPoint": 78,
"heatSetPoint": 70,
"isCancelled": false,
"periodType": "Home",
"startTime": "18:00:00"
}, {
"coolSetPoint": 82,
"heatSetPoint": 62,
"isCancelled": false,
"periodType": "Sleep",
"startTime": "22:00:00"
}]
}]
}
}
GET
Get Schedule
https://api.honeywell.com/v2/devices/schedule/{deviceId}
Get current schedule for a given DeviceID
Response Model ExampleData Definitions
{
"deviceID": "string",
"scheduleType": "None",
"scheduleSubType": "NA",
"timedSchedule": {
"days": [
{
"day": "Monday",
"periods": [
{
"isCancelled": true,
"periodType": "Wake",
"periodName": "string",
"startTime": "string",
"heatSetPoint": 0,
"coolSetPoint": 0,
"fanSwitch": {
"position": "Auto",
"speed": 0
},
"priority": {
"priorityType": "WholeHouse",
"selectedRooms": [
0
]
},
"schedSysSwitch": "On"
}
]
}
]
},
"geoFenceSchedule": {
"homePeriod": {
"heatSetPoint": 0,
"coolSetPoint": 0,
"fanSwitch": {
"position": "Auto",
"speed": 0
},
"priority": {
"priorityType": "WholeHouse",
"selectedRooms": [
0
]
},
"schedSysSwitch": "On"
},
"awayPeriod": {
"heatSetPoint": 0,
"coolSetPoint": 0,
"fanSwitch": {
"position": "Auto",
"speed": 0
},
"priority": {
"priorityType": "WholeHouse",
"selectedRooms": [
0
]
},
"schedSysSwitch": "On"
},
"sleepMode": {
"triggers": [
{
"startTime": "string",
"endTime": "string",
"days": [
"Sunday"
]
}
],
"heatSetPoint": 0,
"coolSetPoint": 0,
"fanSwitch": {
"position": "Auto",
"speed": 0
},
"priority": {
"priorityType": "WholeHouse",
"selectedRooms": [
0
]
},
"schedSysSwitch": "On"
}
},
"otbUpgrading": true,
"scheduleChangeSource": {
"by": "string",
"name": "string"
}
}
Field Name/Location
Data Type
Definition
Required
deviceID
String
DeviceID associated to the schedule
Y
scheduleType
Enum
Schedule type, possible values: None,Geofenced,GeofencedWithSleep,Timed,Partner
Y
scheduleSubType
Enum
Secondary schedule type, "NA", "EMEA", "NONE"
N
timedSchedule
Object
Contains schedule settings
timedSchedule.days
Array
Contains schedule settings
timedSchedule.days.day
Enum
Day of the week 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', 'Sunday'
timedSchedule.days.periods
Object
Schedule periods for the given day
timedSchedule.days.periods.isCancelled
Boolean
True/false if the period is enabled for a given day
timedSchedule.days.periods.periodType
String
Period of the day (e.g, "Wake", "Away", "Home", "Sleep")
timedSchedule.days.periods.startTime
String
Time of the day the schedule period starts, in local time. Always 15 minute increments.
timedSchedule.days.periods.heatSetPoint
Integer
Heating setpoint for the period
timedSchedule.days.periods.coolSetPoint
Integer
Cooling setpoint for the period
timedSchedule.days.periods.fanSwitch
Object
Fan switch scheduling (T9/T10 only)
timedSchedule.days.periods.fanSwitch.position
Enum
Auto, On, Circulate, FollowSchedule
timedSchedule.days.periods.fanSwitch.speed
Number
Always 0
timedSchedule.days.periods.priority
Object
Sensor priority setting for scheduled period (T9/T10 Only)
timedSchedule.days.periods.priority.priorityType
Enum
WholeHouse, PickARoom,FollowMe
timedSchedule.days.periods.priority.selectedRooms
Array
Array of Numbers of Rooms to Prioritize (via Rooms/Groups API)
GET
Get Thermostat
https://api.honeywell.com/v2/devices/thermostats/{deviceId}
Get data for a specific thermostat
Responses will differ based on specific device, equipment setup, and model type. (e.g., some devices do not have a local time-based schedule)
Response Model ExampleData Definitions
{
"displayedOutdoorHumidity": 67,
"vacationHold": {
"enabled": false
},
"currentSchedulePeriod": {
"day": "Thursday",
"period": "Away"
},
"scheduleCapabilities": {
"availableScheduleTypes": [
"None",
"Geofenced",
"TimedNorthAmerica"
],
"schedulableFan": false
},
"scheduleType": {
"scheduleType": "Timed",
"scheduleSubType": "NA"
},
"scheduleStatus": "Resume",
"allowedTimeIncrements": 15,
"settings": {
"hardwareSettings": {
"brightness": 0,
"maxBrightness": 5
},
"fan": {
"allowedModes": [
"On",
"Auto",
"Circulate"
],
"changeableValues": {
"mode": "On"
}
},
"temperatureMode": {
"air": true
},
"specialMode": {
"autoChangeoverActive": false,
"emergencyHeatActive": false
}
},
"deviceClass": "Thermostat",
"deviceType": "Thermostat",
"deviceID": "LCC-00D02DAB5CBE",
"userDefinedDeviceName": "TSeries",
"name": "TSeries",
"isAlive": true,
"isUpgrading": false,
"isProvisioned": true,
"macID": "00D02DAB5CBE",
"deviceSettings": {},
"units": "Fahrenheit",
"indoorTemperature": 73,
"outdoorTemperature": 46,
"allowedModes": [
"EmergencyHeat",
"Heat",
"Off",
"Cool",
"Auto"
],
"deadband": 0,
"hasDualSetpointStatus": false,
"minHeatSetpoint": 50,
"maxHeatSetpoint": 90,
"minCoolSetpoint": 50,
"maxCoolSetpoint": 90,
"changeableValues": {
"mode": "Heat",
"autoChangeoverActive": false,
"emergencyHeatActive": false,
"heatSetpoint": 62,
"coolSetpoint": 85,
"thermostatSetpointStatus": "NoHold",
"nextPeriodTime": "18:00:00",
"endHeatSetpoint": 62,
"endCoolSetpoint": 85,
"heatCoolMode": "Heat"
},
"operationStatus": {
"mode": "EquipmentOff",
"fanRequest": false,
"circulationFanRequest": false
}
}
Field Name/Location
Data Type
Definition
displayedOutdoorHumidity
Integer
Outdoor humidity reading (from weather data), should be treated as percentage
vacationHold
Object
vacationHold.enabled
Boolean
Is vacation hold enabled?
scheduleCapabilities
Object
scheduleCapabilities.availableScheduleTypes
Array
List of available schedule types
scheduleCapabilities.schedulableFan
Boolean
Is the fan mode scheduleable?
scheduleType
Object
scheduleType.scheduleType
String
Current schedule type
scheduleType.scheduleSubType
String
Current schedule sub-type
scheduleStatus
String
Current status of schedule
allowedTimeIncrements
Integer
Allowed time increments of the timed schedule (in minutes)
settings
Object
settings.hardwareSettings
Object
settings.hardwareSettings.brightness
Integer
Current brightness setting
settings.hardwareSettings.maxBrightness
Integer
Maximum brightness setting
settings.fan
Object
settings.fan.allowedModes
Array
Array of allowed fan modes
settings.fan.changeableValues
Object
List of writeable fan settings
settings.temperatureMode
Object
settings.temperatureMode.air
Boolean
settings.specialMode
Object
settings.specialMode.autoChangeoverActive
Boolean
Will exist if device has this mode enabled, true or false based on running in that mode
settings.specialMode.emergencyHeatActive
Boolean
Will exist if device has this mode enabled, true or false based on running in that mode
deviceClass
String
Class of device
deviceType
String
Type of device
deviceID
String
Unique ID of device. "LCC-" == T-Series, "TCC-" == Honeywell Home Round
userDefinedDeviceName
String
User defined name of the device. Shown in the mobile app.
name
String
Device name
isAlive
Boolean
true == device online. false == device offline
isProvisioned
Boolean
Is the device provisioned correctly or not
macID
String
Unique MACID of the device
deviceSettings
Object
units
String
Units used on device (Celsius or Fahrenheit)
indoorTemperature
Integer or Float
Current display temperature on device. Whole numbers for F units or .5 increments for C units.
outdoorTemperature
Integer or Float
Current outdoor temperature based on location data.
allowedModes
Array
List of allowed modes for the device, also be sure to doublecheck settings.specialMode for Round.
deadband
Integer
Required separation between high and low setpoints. Default for Thermostats is 0.
hasDualSetpointStatus
Boolean
Indicates whether the thermostat maintains separate heat and cool setpoint status value.
minHeatSetpoint
Integer or Float
The lower limit for the heating setpoint.
maxHeatSetpoint
Integer or Float
The upper limit for the heating setpoint.
minCoolSetpoint
Integer or Float
The lower limit for the heating setpoint.
maxCoolSetpoint
Integer or Float
The upper limit for the heating setpoint.
changeableValues.mode
String
Current mode of the thermostat.
changeableValues.autoChangeoverActive
Boolean
If field is set in the response then the thermostat supports autochangeover to be controlled independent of mode. If field is not set in the response then the thermostat does not support autochangeover.
changeableValues.emergencyHeatActive
Boolean
Indicates if emergency heating is active. When this field is returned (it is nullable and does not have to be in the response) - it means that the device handles emergency heating independently of the mode. When this field is returned (it is nullable and does not have to be in the response) - device will not accept EmergencyHeat as an allowed value. When emergency heating is active you cannot set thermostat's mode to other value than Off and you cannot change autochangeover.
changeableValues.heatSetpoint
Decimal
Current heating setpoint.
changeableValues.coolSetpoint
Decimal
Current cooling setpoint.
changeableValues.thermostatSetpointStatus
String
Signifies current setpoint state. TemporaryHold, HoldUntil, PermanentHold, VacationHold, NoHold
changeableValues.holdUntil
timeSpan
Time in 15 minutes intervals (the maximum value is 92 = 11:45 PM), meaning depends on other properties.
changeableValues.nextPeriodTime
timeSpan
Indicates when next schedule period starts
changeableValues.endHeatSetpoint
Decimal
The heating setpoint that would occur if the current hold ended now. If there is no hold, or if the thermostat cannot control heating, then this value is not present.
changeableValues.endCoolSetpoint
Decimal
The cooling setpoint that would occur if the current hold ended now. If there is no hold, or if the thermostat cannot control cooling, then this value is not present.
changeableValues.heatCoolMode
String
Heat cool mode when system switch is in Auto mode.
operationStatus
Object
Details around operation status of the equipment.
operationStatus.mode
String
Current running (relay status) of the equipment.
operationStatus.fanRequest
Boolean
Current running (relay status) of the fan.
operationStatus.circulationFanRequest
Boolean
Current running (relay status) of the fan circulate mode.
smartAway
Object
Settings that will take effect when nobody is home (via Geofencing). Null when reported means smart away is not available.
indoorHumidity
Decimal
Indoor humidity rating as a percentage
indoorHumidityStatus
String
Status of humidity sensor. Measured, NotAvailable, or SensorFault.
POST
Change fan setting for device
https://api.honeywell.com/v2/devices/thermostats/{deviceId}/fan
Change the current Fan setting for specified DeviceID.
Example:
{
"mode": "On"
}
GET
Get current fan settings
https://api.honeywell.com/v2/devices/thermostats/{deviceId}/fan
Get current fan settings for specified DeviceID
Response Model ExampleData Definitions
{
"allowedModes": [
"Auto",
"Auto",
"Auto"
],
"changeableValues": {
"mode": "Auto"
},
"fanRunning": true
}
Field Name/Location
Data Type
Definition
allowedModes
Array
Shows allowed modes for fan: On, Auto, Circulate
changeableValues
Object
Values you can change
changeableValues.mode
String
Current setting for fan mode
fanRunning
Boolean
Current fan state
POST
Change Thermostat Settings
https://api.honeywell.com/v2/devices/thermostats/{deviceId}
Change the setpoint, system mode, and auto changeover status of a thermostat. Take care to track current consumer setting for AutoChangeover so it's not disabled or enabled unintentionally.
Homeywell Home T-Series devices also have the capability of a 7-day schedule as well as geofencing. When sending a setpoint change request you have a few options:
"NoHold" - This will set the device to run the current schedule
"TemporaryHold" - No "nextPeriodTime" is required, the thermostat will hold the temperature until the next schedule period change.
"PermanentHold" - This will hold the setpoint until the next consumer interation.
"HoldUntil" - Requires a "nextPeriodTime" value, the thermostat will hold the requested setpoint(s) until that time.
Example for TCC device:
{
"mode": "Cool",
"autoChangeoverActive": true,
"heatSetpoint": 72,
"coolSetpoint": 74
}
Example for LCC device:
{
"mode": "Heat",
"heatSetpoint": 62,
"coolSetpoint": 80,
"thermostatSetpointStatus": "TemporaryHold"
}
Data Definitions
Field Name/Location
Data Type
Definition
Mode
String
Mode to set to, must match available modes. Heat, Cool, Off
AutoChangeoverActive
Boolean
If field is set in the response then the thermostat supports autochangeover to be controlled independent of mode. If field is not set in the response then the thermostat does not support autochangeover to be controlled independent of mode and you must look into AllowedModes to see it the thermostat supports at least autochangeover controllable by mode.
EmergencyHeatActive
Boolean
Indicates if emergency heating is active. Do not send if Emergency Heat is false.
HeatSetpoint
Decimal
New value for heat setpoint. Whole numbers for F and half increments for C units.
CoolSetpoint
Decimal
New value for cool setpoint. Whole numbers for F and half increments for C units.
thermostatSetpointStatus
String
For "LCC-" devices only. "NoHold" will return to schedule. "TemporaryHold" will hold the set temperature until "nextPeriodTime". "PermanentHold" will hold the setpoint until user requests another change.
nextPeriodTime
String
For "LCC-" devices only. "NoHold" will return to schedule. "TemporaryHold" will hold the set temperature until "nextPeriodTime". "PermanentHold" will hold the setpoint until user requests another change.
DHW
Method
Description
Method
Description
PUT
Set DHW System Switch
https://api.honeywell.com/v2/devices/dhw/{deviceId}/systemSwitch
Change the system switch of the hot water system. "Off" will set the system to "Always Off" and it will not follow schedule. "Heat" will set the system to "Always On" and it will not follow schedule.
To resume schedule after turning on the system switch, send a "off" command to /state.
Example Off:
{
"systemSwitch": "Off"
}
Example On:
{
"systemSwitch": "Heat"
}
PUT
Set DHW operation & boost state
https://api.honeywell.com/v2/devices/dhw/{deviceId}/state
Change the on/off state of DHW and boost time. Allowed boost times are 30, 60, 90 minutes.
Example Off:
{
"dhwState": "Off",
"boostTime": 0
}
Example On with Boost for 30 minutes:
{
"dhwState": "One",
"boostTime": 30
}
PUT
Set DHW Schedule
https://api.honeywell.com/v2/devices/dhw/{deviceId}/schedule
Set Hot Water schedule for a specific device.
Request Body Example:
{
"deviceId": "00D02DE7ED4E",
"timedSchedule": {
"days": [
{
"day": "Monday",
"periods": [
{
"startTime": "06:00:00",
"dhwState": "On"
},
{
"startTime": "08:50:00",
"dhwState": "Off"
}
]
},
{
"day": "Tuesday",
"periods": [
{
"startTime": "06:30:00",
"dhwState": "On"
},
{
"startTime": "09:00:00",
"dhwState": "Off"
},
{
"startTime": "17:30:00",
"dhwState": "On"
},
{
"startTime": "19:00:00",
"dhwState": "Off"
}
]
},
{
"day": "Wednesday",
"periods": [
{
"startTime": "06:00:00",
"dhwState": "On"
},
{
"startTime": "11:50:00",
"dhwState": "Off"
}
]
},
{
"day": "Thursday",
"periods": [
{
"startTime": "06:00:00",
"dhwState": "On"
},
{
"startTime": "11:50:00",
"dhwState": "Off"
}
]
},
{
"day": "Friday",
"periods": [
{
"startTime": "06:00:00",
"dhwState": "On"
},
{
"startTime": "11:50:00",
"dhwState": "Off"
}
]
},
{
"day": "Saturday",
"periods": [
{
"startTime": "06:00:00",
"dhwState": "On"
},
{
"startTime": "11:50:00",
"dhwState": "Off"
}
]
},
{
"day": "Sunday",
"periods": [
{
"startTime": "06:00:00",
"dhwState": "On"
},
{
"startTime": "11:50:00",
"dhwState": "Off"
}
]
}
]
}
}
Field Name/Location
Data Type
Definition
GET
Get DHW Schedule
https://api.honeywell.com/v2/devices/dhw/{deviceId}/schedule
Get current Hot Water schedule for a specific device.
Response Model Example
Data Definitions
{
"deviceId": "00D02DE7ED4E",
"timedSchedule": {
"days": [
{
"day": "Monday",
"periods": [
{
"startTime": "06:00:00",
"dhwState": "On"
},
{
"startTime": "08:50:00",
"dhwState": "Off"
}
]
},
{
"day": "Tuesday",
"periods": [
{
"startTime": "06:30:00",
"dhwState": "On"
},
{
"startTime": "09:00:00",
"dhwState": "Off"
},
{
"startTime": "17:30:00",
"dhwState": "On"
},
{
"startTime": "19:00:00",
"dhwState": "Off"
}
]
},
{
"day": "Wednesday",
"periods": [
{
"startTime": "06:00:00",
"dhwState": "On"
},
{
"startTime": "11:50:00",
"dhwState": "Off"
}
]
},
{
"day": "Thursday",
"periods": [
{
"startTime": "06:00:00",
"dhwState": "On"
},
{
"startTime": "11:50:00",
"dhwState": "Off"
}
]
},
{
"day": "Friday",
"periods": [
{
"startTime": "06:00:00",
"dhwState": "On"
},
{
"startTime": "11:50:00",
"dhwState": "Off"
}
]
},
{
"day": "Saturday",
"periods": [
{
"startTime": "06:00:00",
"dhwState": "On"
},
{
"startTime": "11:50:00",
"dhwState": "Off"
}
]
},
{
"day": "Sunday",
"periods": [
{
"startTime": "06:00:00",
"dhwState": "On"
},
{
"startTime": "11:50:00",
"dhwState": "Off"
}
]
}
]
}
}
Field Name/Location
Data Type
Definition
Smart Home Security
Method
Description
Method
Description
PUT
Change Z-Wave Switch/Outlet
https://api.honeywell.com/v2/homesecurity/devices/{deviceId}/switches/{switchId}/state
Change the state of a z-wave switch or outlet. Switch ID can be found in the GET /locations resource.
Example Off:
{
"state": "Off"
}
Example On:
{
"state": "On"
}
Example Brightness:
{
"value": 80
}
GET
Get Activity Log
https://api.honeywell.com/v2/homesecurity/devices/{deviceId}/ActivityLogs
Get the activity log for a Smart Home Security Base Station.
Response Model Example
Data Definitions
{
"activityLogData": [
{
"index": 3,
"id": 2434614,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-06T15:57:57.0000000Z",
"eventTrigger": "Device",
"eventType": "MotionDetected",
"eventSubType": "MotionStarted",
"systemMode": "Unknown",
"message": {
"locationName": "",
"deviceName": "Security",
"subDeviceName": "Living Room",
"subDeviceClass": "Camera",
"subDeviceType": "BuiltIn",
"userName": "",
"clipId": "a079d8e5-ebe9-4b64-ab7d-cfdf056aff85",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 0
},
{
"index": 4,
"id": 2434577,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-06T15:57:56.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "Disarm",
"systemMode": "Disarm",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 5,
"id": 2434565,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-06T15:57:37.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "ArmAway",
"systemMode": "ArmAway",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 6,
"id": 2369875,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-03T20:23:32.0000000Z",
"eventTrigger": "Device",
"eventType": "System",
"eventSubType": "SystemTamper",
"systemMode": "Unknown",
"message": {
"locationName": "",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 0
},
{
"index": 7,
"id": 2368107,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-03T18:58:00.0000000Z",
"eventTrigger": "Device",
"eventType": "System",
"eventSubType": "SystemTamper",
"systemMode": "Unknown",
"message": {
"locationName": "",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 0
},
{
"index": 8,
"id": 2365981,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-03T17:13:53.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "Disarm",
"systemMode": "Disarm",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 9,
"id": 2365979,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-03T17:13:45.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "ArmAway",
"systemMode": "ArmAway",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 10,
"id": 2345780,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T19:48:46.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "Disarm",
"systemMode": "Disarm",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 11,
"id": 2345775,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T19:48:24.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "Disarm",
"systemMode": "Disarm",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 12,
"id": 2344878,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T18:56:34.0000000Z",
"eventTrigger": "Device",
"eventType": "MotionDetected",
"eventSubType": "MotionStarted",
"systemMode": "Unknown",
"message": {
"locationName": "",
"deviceName": "Security",
"subDeviceName": "Living Room",
"subDeviceClass": "Camera",
"subDeviceType": "BuiltIn",
"userName": "",
"clipId": "00e7fdf4-e8c0-4b95-b108-166704eb1604",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 0
},
{
"index": 13,
"id": 2344843,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T18:56:32.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "Disarm",
"systemMode": "Disarm",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 14,
"id": 2344596,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T18:43:34.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "Disarm",
"systemMode": "Disarm",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 15,
"id": 2343251,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:25:59.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "Disarm",
"systemMode": "Disarm",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 16,
"id": 2343130,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:20:17.0000000Z",
"eventTrigger": "Device",
"eventType": "System",
"eventSubType": "SystemAcLossClear",
"systemMode": "Unknown",
"message": {
"locationName": "",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 0
},
{
"index": 17,
"id": 2343129,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:20:16.0000000Z",
"eventTrigger": "Device",
"eventType": "System",
"eventSubType": "SystemTamper",
"systemMode": "Unknown",
"message": {
"locationName": "",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 0
},
{
"index": 18,
"id": 2343128,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:20:12.0000000Z",
"eventTrigger": "Device",
"eventType": "System",
"eventSubType": "SystemTamper",
"systemMode": "Unknown",
"message": {
"locationName": "",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 0
},
{
"index": 19,
"id": 2343120,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:20:00.0000000Z",
"eventTrigger": "Device",
"eventType": "System",
"eventSubType": "SystemTamper",
"systemMode": "Unknown",
"message": {
"locationName": "",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 0
},
{
"index": 20,
"id": 2343116,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:19:55.0000000Z",
"eventTrigger": "Device",
"eventType": "System",
"eventSubType": "SystemTamper",
"systemMode": "Unknown",
"message": {
"locationName": "",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 0
},
{
"index": 21,
"id": 2343112,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:19:51.0000000Z",
"eventTrigger": "Device",
"eventType": "System",
"eventSubType": "SystemTamper",
"systemMode": "Unknown",
"message": {
"locationName": "",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 0
},
{
"index": 22,
"id": 2343111,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:19:46.0000000Z",
"eventTrigger": "Device",
"eventType": "System",
"eventSubType": "SystemTamper",
"systemMode": "Unknown",
"message": {
"locationName": "",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 0
},
{
"index": 23,
"id": 2343108,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:19:42.0000000Z",
"eventTrigger": "Device",
"eventType": "System",
"eventSubType": "SystemTamper",
"systemMode": "Unknown",
"message": {
"locationName": "",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 0
},
{
"index": 24,
"id": 2343105,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:19:37.0000000Z",
"eventTrigger": "Device",
"eventType": "System",
"eventSubType": "SystemTamper",
"systemMode": "Unknown",
"message": {
"locationName": "",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 0
},
{
"index": 25,
"id": 2343100,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:19:33.0000000Z",
"eventTrigger": "Device",
"eventType": "System",
"eventSubType": "SystemTamper",
"systemMode": "Unknown",
"message": {
"locationName": "",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 0
},
{
"index": 26,
"id": 2343099,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:19:33.0000000Z",
"eventTrigger": "Device",
"eventType": "System",
"eventSubType": "SystemAcLoss",
"systemMode": "Unknown",
"message": {
"locationName": "",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 0
},
{
"index": 27,
"id": 2343028,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:16:35.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "Disarm",
"systemMode": "Disarm",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 28,
"id": 2343020,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:16:03.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "ArmStay",
"systemMode": "ArmStay",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 29,
"id": 2343004,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:15:29.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "ArmStay",
"systemMode": "ArmStay",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 30,
"id": 2343042,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:15:04.0000000Z",
"eventTrigger": "Device",
"eventType": "MotionDetected",
"eventSubType": "MotionStarted",
"systemMode": "Unknown",
"message": {
"locationName": "",
"deviceName": "Security",
"subDeviceName": "Living Room",
"subDeviceClass": "Camera",
"subDeviceType": "BuiltIn",
"userName": "",
"clipId": "50a72fa9-2109-417a-9b31-47a9bbe85cf1",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 0
},
{
"index": 31,
"id": 2342997,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:15:01.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "Disarm",
"systemMode": "Disarm",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 32,
"id": 2342989,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:14:46.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "Disarm",
"systemMode": "Disarm",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 33,
"id": 2342988,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:14:30.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "Disarm",
"systemMode": "Disarm",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 34,
"id": 2342971,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:13:30.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "Disarm",
"systemMode": "Disarm",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 35,
"id": 2342964,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:13:03.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "Disarm",
"systemMode": "Disarm",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 36,
"id": 2342963,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:13:00.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "ArmAway",
"systemMode": "ArmAway",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 37,
"id": 2342998,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:12:59.0000000Z",
"eventTrigger": "Device",
"eventType": "MotionDetected",
"eventSubType": "MotionStarted",
"systemMode": "Unknown",
"message": {
"locationName": "",
"deviceName": "Security",
"subDeviceName": "Living Room",
"subDeviceClass": "Camera",
"subDeviceType": "BuiltIn",
"userName": "",
"clipId": "5ae3e904-127f-4bb4-af31-e3aba843f3bf",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 0
},
{
"index": 38,
"id": 2342903,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:09:51.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "Disarm",
"systemMode": "Disarm",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 39,
"id": 2342939,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:09:49.0000000Z",
"eventTrigger": "Device",
"eventType": "MotionDetected",
"eventSubType": "MotionStarted",
"systemMode": "Unknown",
"message": {
"locationName": "",
"deviceName": "Security",
"subDeviceName": "Living Room",
"subDeviceClass": "Camera",
"subDeviceType": "BuiltIn",
"userName": "",
"clipId": "d252a217-6df9-4f76-bf90-5d85a2c4375e",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 0
},
{
"index": 40,
"id": 2342929,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:09:49.0000000Z",
"eventTrigger": "Device",
"eventType": "MotionDetected",
"eventSubType": "MotionStarted",
"systemMode": "Unknown",
"message": {
"locationName": "",
"deviceName": "Security",
"subDeviceName": "Living Room",
"subDeviceClass": "Camera",
"subDeviceType": "BuiltIn",
"userName": "",
"clipId": "02d07880-44fc-4b06-908d-01091dffcbef",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 0
},
{
"index": 41,
"id": 2342859,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:07:35.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "Disarm",
"systemMode": "Disarm",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 42,
"id": 2342857,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:07:32.0000000Z",
"eventTrigger": "VoiceCommand",
"eventType": "Partition",
"eventSubType": "ArmAway",
"systemMode": "ArmAway",
"message": {
"locationName": "",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 0
},
{
"index": 43,
"id": 2342851,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:07:16.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "Disarm",
"systemMode": "Disarm",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 44,
"id": 2342709,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:00:17.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "Disarm",
"systemMode": "Disarm",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 45,
"id": 2342704,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T17:00:08.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "ArmStay",
"systemMode": "ArmStay",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 46,
"id": 2342657,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T16:58:00.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "ArmStay",
"systemMode": "ArmStay",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 47,
"id": 2342654,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T16:57:34.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "Disarm",
"systemMode": "Disarm",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 48,
"id": 2342647,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T16:57:18.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "ArmStay",
"systemMode": "ArmStay",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 49,
"id": 2342599,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T16:54:50.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "Disarm",
"systemMode": "Disarm",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
},
{
"index": 50,
"id": 2342589,
"tenantId": 1,
"corId": "",
"eventDateTime": "2018-08-02T16:54:28.0000000Z",
"eventTrigger": "App",
"eventType": "Partition",
"eventSubType": "ArmStay",
"systemMode": "ArmStay",
"message": {
"locationName": "Home",
"deviceName": "Security",
"subDeviceName": "",
"subDeviceClass": "",
"subDeviceType": "",
"userName": "hw",
"clipId": "",
"rpn": "",
"unknownPersonCount": 0,
"refId": ""
},
"userId": 625115
}
],
"totalLogs": 50
}
Field Name/Location
Data Type
Definition
activityLogData
Array
Array of Activity Log objects (one for each activity)
index
Number
Index number of the activity
id
Number
Identifier of the activity
tenantId
Integer
corId
String
eventDateTime
DateTime
Date and time of the activity
eventTrigger
String
Where the event was triggered from
eventType
String
Type of event
eventSubType
String
Sub type of event
systemMode
String
message
Object
Details of the activity (usually defines sub source, like camera or sensor.
message.locationName
String
message.deviceName
String
Name of device (usually the base station)
message.subDeviceName
String
Name of the sub device (e.g., Camera, sensor name)
message.subDeviceClass
String
Type of sub device
message.subDeviceType
String
Device type (e.g., BuiltIn)
userId
Number
UserId who made the change (if it was executed by a user)
PUT
Arm or Disarm the System
https://api.honeywell.com/v2/homesecurity/devices/{deviceId}/partitions/{partitionId}/{arm}
Change the arm/disarm state for a requested device within a location. Change the string on the end of the URI ("Arm" for arming, "Disarm" for disarming)
Valid Arm types:
"ArmAway" - Also "Away" in the app
"ArmStay" - Also "Night" in the app
Valid Disarm types:
"True" - Also "Off" in the app
"False" - Also "Home" in the app
Example Arm:
{
"armType": "ArmAway"
}
Example Disarm:
{
"EnableSilentMode": "false"
}
Camera
Method
Description
Method
Description
POST
Change Camera Config
https://api.honeywell.com/v2/devices/cameras/{deviceId}/config
Change the configuration of a specific camera within a location.
Note: The entire configuration must be sent each time, even with unchanged values!
Request Example
Data Definitions
{
"version": "1.0",
"deviceId": "07182FC1FC35D69780DEE2E889E15BEBC1814624F260B04759827DBBD6E2EB6A",
"audioDetection": "off",
"audioSensitivity": 66,
"micStatus": "on",
"speakerStatus": "on",
"motionDetection": "on",
"motionArea": [
{
"startX": 0,
"startY": 0,
"width": 599,
"height": 311,
"sensitivity": 99
},
{
"startX": 45,
"startY": 485,
"width": 206,
"height": 214,
"sensitivity": 33
}
],
"nightMode": "auto",
"ledStatus": "on",
"aheadRecording": 5,
"storagePlan": "day",
"motionZone": "rectangle",
"privacyMode": "off",
"geoFence": "off"
}
Field Name/Location
Data Type
Definition
version
String
Version of the sensor
deviceId
String
deviceId of the sensor
audioDetection
String
Audio detection on/off
audioSenstivity
Integer
Current audio sensitivity setting: 0-100
micStatus
String
Microphone on/off
speakerStatus
String
Speaker on/off
motionDetection
String
Motion detection on/off
motionArea
Array
Array defining all motion detection areas
motionArea.startX
Integer
Starting X resoultion position of the area
motionArea.startY
Integer
Starting Y resolution position of the area
motionArea.width
Integer
Width of the detection area
motionArea.height
Integer
Height of the detection area
motionArea.sensitivity
Integer
Sensitivity level of motion detection for the area. The higher the value the greater sensitivity. (0, 33, 66, 99)
nightMode
String
Night vision mode
ledStatus
String
State of the front LED
aheadRecording
Integer
storagePlan
String
Video clip storage plan
motionZone
String
Shape of the motion detection zone
privacyMode
String
Privacy mode state
geoFence
String
Geofencing state. Typically this results in camera being OFF when home and ON when away.
GET
Get Camera Configuration
https://api.honeywell.com/v2/devices/cameras/{deviceId}/config
Get configuration information for a specific camera assigned to a location.
Response Model Example
Data Definitions
{
"version": "1.0",
"deviceId": "07182FC1FC35D69780DEE2E889E15BEBC1814624F260B04759827DBBD6E2EB6A",
"audioDetection": "off",
"audioSensitivity": 66,
"micStatus": "on",
"speakerStatus": "on",
"motionDetection": "on",
"motionArea": [
{
"startX": 0,
"startY": 0,
"width": 599,
"height": 311,
"sensitivity": 99
},
{
"startX": 45,
"startY": 485,
"width": 206,
"height": 214,
"sensitivity": 33
}
],
"nightMode": "auto",
"ledStatus": "on",
"aheadRecording": 5,
"storagePlan": "day",
"motionZone": "rectangle",
"privacyMode": "off",
"geoFence": "off"
}
Field Name/Location
Data Type
Definition
version
String
Version of the sensor
deviceId
String
deviceId of the sensor
audioDetection
String
Audio detection on/off
audioSenstivity
Integer
Current audio sensitivity setting: 0-100
micStatus
String
Microphone on/off
speakerStatus
String
Speaker on/off
motionDetection
String
Motion detection on/off
motionArea
Array
Array defining all motion detection areas
motionArea.startX
Integer
Starting X resoultion position of the area
motionArea.startY
Integer
Starting Y resolution position of the area
motionArea.width
Integer
Width of the detection area
motionArea.height
Integer
Height of the detection area
motionArea.sensitivity
Integer
Sensitivity level of motion detection for the area. The higher the value the greater sensitivity. (0, 33, 66, 99)
nightMode
String
Night vision mode
ledStatus
String
State of the front LED
aheadRecording
Integer
storagePlan
String
Video clip storage plan
motionZone
String
Shape of the motion detection zone
privacyMode
String
Privacy mode state
geoFence
String
Geofencing state. Typically this results in camera being OFF when home and ON when away.
GET
Get a Specific Camera in a Location
https://api.honeywell.com/v2/devices/cameras/{deviceId}
Get information for a specific camera assigned to a particular location.
Response Model Example
Data Definitions
{
"model": "C1",
"serial": "1709ZA30611",
"maxResolution": "1280x720",
"firmwareVer": "v0.97_20170506",
"deviceClass": "Camera",
"deviceType": "C1",
"deviceID": "41654c77-a233-4c31-ac4b-464bb62c01cb",
"userDefinedDeviceName": "Camera",
"isAlive": true,
"isUpgrading": false,
"isProvisioned": true,
"macID": "74DA38C04032"
}
Field Name/Location
Data Type
Definition
model
String
Model of the camera
serial
String
Serial Number of the camera
maxResolution
String
Max recording/display resolution of the camera (e.g., "1280x720")
firmwareVer
String
Current running firmware version
deviceClass
String
Class of the device (e.g., "Camera", "Thermostat")
deviceType
String
Type of the device
deviceID
String
Unique ID of the device
userDefinedDeviceName
String
User defined name of the device
isAlive
Boolean
Online/offline state of the camera. True = Online.
isUpgrading
Boolean
Is the camera currently upgrading firmware true/false
isProvisioned
Boolean
Is the camera currently provisioned correctly true/false
macID
String
MacID of the device
GET
Get Notifications for a Camera
https://api.honeywell.com/v2/devices/cameras/{deviceId}/notifications
Get notifications for a specific camera assigned to a location. The resource will return the last 20 notifications.
Possible notification types: "Camera","DeviceOffline","STATUSCHANGE",
"SOUNDDETECTED","MOTIONDETECTED","SecurityEvents","Alarms","StatusChange",
"Trouble","Alert","AutomationEvents","Alarms","StatusChange","Trouble","Alert",
"DEVICEACTIVATED","DEVICEDEACTIVATED","FIRMWAREUPDATE","CLIPREADY"
Response Model Example
Data Definitions
[
{
"group": "FIRMWAREUPDATE",
"id": 29588583,
"deviceName": "Camera",
"status": "UnRead",
"shortDescription": "Your Camera at Home is now upgraded to Firmware version v0.97_20170506",
"dateTime": 1494267927,
"startTime": 0,
"expiryTime": 0,
"title": "Your Camera at Home is now upgraded to Firmware version v0.97_20170506",
"description": "Your Camera at Home is now upgraded to Firmware version v0.97_20170506",
"locationID": 75499,
"deviceId": "41654c77-a233-4c31-ac4b-464bb62c01cb"
},
{
"group": "STATUSCHANGE",
"id": 28756435,
"deviceName": "Camera",
"status": "UnRead",
"shortDescription": "Your Camera at Home is Available",
"dateTime": 1493762887,
"startTime": 0,
"expiryTime": 0,
"title": "Your Camera at Home is Available",
"description": "Your Camera at Home is Available",
"locationID": 75499,
"deviceId": "41654c77-a233-4c31-ac4b-464bb62c01cb"
},
{
"group": "DEVICEACTIVATED",
"id": 28756434,
"deviceName": "Camera",
"status": "UnRead",
"shortDescription": "Camera activation has been Succeeded in Home",
"dateTime": 1493762887,
"startTime": 0,
"expiryTime": 0,
"title": "Camera activation has been Succeeded in Home",
"description": "Camera activation has been Succeeded in Home",
"locationID": 75499,
"deviceId": "41654c77-a233-4c31-ac4b-464bb62c01cb"
}
]
Field Name/Location
Data Type
Definition
group
String
Type of notification
id
Integer
ID of the notification
deviceName
String
Name of the device in the notification
status
String
Status of the notification
shortDescription
String
Short description of the notification content
dateTime
Timestamp
Unix epoch of the notification time
startTime
expiryTime
title
String
Title of the notification
description
String
Description of the notification
locationID
Integer
ID of the location the notification belongs to
deviceId
String
Unique deviceId the notification is referencing
GET
Get cameras for a Location
https://api.honeywell.com/v2/devices/cameras
Get information for all cameras assigned to a particular location.
Response Model Example
Data Definitions
[
{
"model": "C1",
"serial": "1709ZA30611",
"maxResolution": "1280x720",
"firmwareVer": "v0.97_20170506",
"deviceClass": "Camera",
"deviceType": "C1",
"deviceID": "41654c77-a233-4c31-ac4b-464bb62c01cb",
"userDefinedDeviceName": "Camera",
"isAlive": true,
"isUpgrading": false,
"isProvisioned": true,
"macID": "74DA38C04032"
}
]
Field Name/Location
Data Type
Definition
model
String
Model of the camera
serial
String
Serial Number of the camera
maxResolution
String
Max recording/display resolution of the camera (e.g., "1280x720")
firmwareVer
String
Current running firmware version
deviceClass
String
Class of the device (e.g., "Camera", "Thermostat")
deviceType
String
Type of the device
deviceID
String
Unique ID of the device
userDefinedDeviceName
String
User defined name of the device
isAlive
Boolean
Online/offline state of the camera. True = Online.
isUpgrading
Boolean
Is the camera currently upgrading firmware true/false
isProvisioned
Boolean
Is the camera currently provisioned correctly true/false
macID
String
MacID of the device
Thermostat
Method
Description
, Water Leak Detector
Method
Description
Method
Description
Method
Description
GET
Get a Specific Device by ID
https://api.honeywell.com/v2/devices/{deviceType}/{deviceId}
Use this method to get a specific device by type, ID and locationId.
Valid device types for URI: "thermostats", "waterLeakDetectors", and "cameras"
Responses will differ based on specific device, equipment setup, and model type.
Response Model for ThermostatResponse Model for Water Leak DetectorResponse Model for Camera
Data Definitions for ThermostatData Definitions for Water Leak DetectorData Definitions for Camera
{
"displayedOutdoorHumidity": 67,
"vacationHold": {
"enabled": false
},
"currentSchedulePeriod": {
"day": "Thursday",
"period": "Away"
},
"scheduleCapabilities": {
"availableScheduleTypes": [
"None",
"Geofenced",
"TimedNorthAmerica"
],
"schedulableFan": false
},
"scheduleType": {
"scheduleType": "Timed",
"scheduleSubType": "NA"
},
"scheduleStatus": "Resume",
"allowedTimeIncrements": 15,
"settings": {
"hardwareSettings": {
"brightness": 0,
"maxBrightness": 5
},
"fan": {
"allowedModes": [
"On",
"Auto",
"Circulate"
],
"changeableValues": {
"mode": "On"
}
},
"temperatureMode": {
"air": true
},
"specialMode": {
"autoChangeoverActive": false,
"emergencyHeatActive": false
}
},
"deviceClass": "Thermostat",
"deviceType": "Thermostat",
"deviceID": "LCC-00D02DAB5CBE",
"userDefinedDeviceName": "TSeries",
"name": "TSeries",
"isAlive": true,
"isUpgrading": false,
"isProvisioned": true,
"macID": "00D02DAB5CBE",
"deviceSettings": {},
"units": "Fahrenheit",
"indoorTemperature": 73,
"outdoorTemperature": 46,
"allowedModes": [
"EmergencyHeat",
"Heat",
"Off",
"Cool",
"Auto"
],
"deadband": 0,
"hasDualSetpointStatus": false,
"minHeatSetpoint": 50,
"maxHeatSetpoint": 90,
"minCoolSetpoint": 50,
"maxCoolSetpoint": 90,
"changeableValues": {
"mode": "Heat",
"autoChangeoverActive": false,
"emergencyHeatActive": false,
"heatSetpoint": 62,
"coolSetpoint": 85,
"thermostatSetpointStatus": "NoHold",
"nextPeriodTime": "18:00:00",
"endHeatSetpoint": 62,
"endCoolSetpoint": 85,
"heatCoolMode": "Heat"
},
"operationStatus": {
"mode": "EquipmentOff",
"fanRequest": false,
"circulationFanRequest": false
}
}
Field Name/Location
Data Type
Definition
displayedOutdoorHumidity
Integer
Outdoor humidity reading (from weather data), should be treated as percentage
vacationHold
Object
vacationHold.enabled
Boolean
Is vacation hold enabled?
scheduleCapabilities
Object
scheduleCapabilities.availableScheduleTypes
Array
List of available schedule types
scheduleCapabilities.schedulableFan
Boolean
Is the fan mode scheduleable?
scheduleType
Object
scheduleType.scheduleType
String
Current schedule type
scheduleType.scheduleSubType
String
Current schedule sub-type
scheduleStatus
String
Current status of schedule
allowedTimeIncrements
Integer
Allowed time increments of the timed schedule (in minutes)
settings
Object
settings.hardwareSettings
Object
settings.hardwareSettings.brightness
Integer
Current brightness setting
settings.hardwareSettings.maxBrightness
Integer
Maximum brightness setting
settings.fan
Object
settings.fan.allowedModes
Array
Array of allowed fan modes
settings.fan.changeableValues
Object
List of writeable fan settings
settings.temperatureMode
Object
settings.temperatureMode.air
Boolean
settings.specialMode
Object
settings.specialMode.autoChangeoverActive
Boolean
Will exist if device has this mode enabled, true or false based on running in that mode
settings.specialMode.emergencyHeatActive
Boolean
Will exist if device has this mode enabled, true or false based on running in that mode
deviceClass
String
Class of device
deviceType
String
Type of device
deviceID
String
Unique ID of device. "LCC-" == T-Series, "TCC-" == Round
userDefinedDeviceName
String
User defined name of the device. Shown in the mobile app.
name
String
Device name
isAlive
Boolean
true == device online. false == device offline
isProvisioned
Boolean
Is the device provisioned correctly or not
macID
String
Unique MACID of the device
deviceSettings
Object
units
String
Units used on device (Celsius or Fahrenheit)
indoorTemperature
Integer or Float
Current display temperature on device. Whole numbers for F units or .5 increments for C units.
outdoorTemperature
Integer or Float
Current outdoor temperature based on location data.
allowedModes
Array
List of allowed modes for the device, also be sure to doublecheck settings.specialMode for Round.
deadband
Integer
Required separation between high and low setpoints. Default for Thermostats is 0.
hasDualSetpointStatus
Boolean
Indicates whether the thermostat maintains separate heat and cool setpoint status value.
minHeatSetpoint
Integer or Float
The lower limit for the heating setpoint.
maxHeatSetpoint
Integer or Float
The upper limit for the heating setpoint.
minCoolSetpoint
Integer or Float
The lower limit for the heating setpoint.
maxCoolSetpoint
Integer or Float
The upper limit for the heating setpoint.
changeableValues.mode
String
Current mode of the thermostat.
changeableValues.autoChangeoverActive
Boolean
If field is set in the response then the thermostat supports autochangeover to be controlled independent of mode. If field is not set in the response then the thermostat does not support autochangeover.
changeableValues.emergencyHeatActive
Boolean
Indicates if emergency heating is active. When this field is returned (it is nullable and does not have to be in the response) - it means that the device handles emergency heating independently of the mode. When this field is returned (it is nullable and does not have to be in the response) - device will not accept EmergencyHeat as an allowed value. When emergency heating is active you cannot set thermostat's mode to other value than Off and you cannot change autochangeover.
changeableValues.heatSetpoint
Decimal
Current heating setpoint.
changeableValues.coolSetpoint
Decimal
Current cooling setpoint.
changeableValues.thermostatSetpointStatus
String
Signifies current setpoint state. TemporaryHold, HoldUntil, PermanentHold, VacationHold, NoHold
changeableValues.holdUntil
timeSpan
Time in 15 minutes intervals (the maximum value is 92 = 11:45 PM), meaning depends on other properties.
changeableValues.nextPeriodTime
timeSpan
Indicates when next schedule period starts
changeableValues.endHeatSetpoint
Decimal
The heating setpoint that would occur if the current hold ended now. If there is no hold, or if the thermostat cannot control heating, then this value is not present.
changeableValues.endCoolSetpoint
Decimal
The cooling setpoint that would occur if the current hold ended now. If there is no hold, or if the thermostat cannot control cooling, then this value is not present.
changeableValues.heatCoolMode
String
Heat cool mode when system switch is in Auto mode.
operationStatus
Object
Details around operation status of the equipment.
operationStatus.mode
String
Current running (relay status) of the equipment.
operationStatus.fanRequest
Boolean
Current running (relay status) of the fan.
operationStatus.circulationFanRequest
Boolean
Current running (relay status) of the fan circulate mode.
smartAway
Object
Settings that will take effect when nobody is home (via Geofencing). Null when reported means smart away is not available.
indoorHumidity
Decimal
Indoor humidity rating as a percentage, currently only on Round thermostats
indoorHumidityStatus
String
Status of humidity sensor. Measured, NotAvailable, or SensorFault.
{
"firmwareVer": "0.5.16A4",
"waterPresent": false,
"currentSensorReadings": {
"time": "2017-10-19T08:27:42",
"temperature": 20.39,
"humidity": 44.8
},
"currentAlarms": [],
"lastCheckin": "2017-10-19T08:27:44",
"lastDeviceSettingUpdatedOn": "0001-01-01T00:00:00",
"batteryRemaining": 43,
"isRegistered": true,
"hasDeviceCheckedIn": true,
"isDeviceOffline": false,
"firstFailedAttemptTime": "0001-01-01T00:00:00",
"failedConnectionAttempts": 0,
"wifiSignalStrength": -46,
"isFirmwareUpdateRequired": false,
"time": "2017-10-19T08:27:42",
"deviceClass": "LeakDetector",
"deviceType": "Water Leak Detector",
"deviceID": "31aae686-6b4a-476e-8cbc-da4a1cab2cd5",
"userDefinedDeviceName": "Basement",
"backend": {
"id": "31aae686-6b4a-476e-8cbc-da4a1cab2cd5"
},
"isAlive": true,
"isUpgrading": false,
"isProvisioned": true,
"deviceSettings": {
"temp": {
"high": {
"limit": 36.5
},
"low": {
"limit": 6.5
}
},
"humidity": {
"high": {
"limit": 70
},
"low": {
"limit": 20
}
},
"userDefinedName": "Basement",
"buzzerMuted": false,
"checkinPeriod": 8,
"currentSensorReadPeriod": 60
}
}
Field Name/Location
Data Type
Definition
firmwareVer
String
Current firmware version
waterPresent
Boolean
True if water has been detected
currentSensorReadings
Object
currentSensorReadings.time
DateTime
Timestamp of last reading
currentSensorReadings.temperature
Decimal
Last read temperature, always in C units
currentSensorReadings.humidity
Percentage
Last read humidity, always a percentage
currentAlarms
Object Array
Array of objects for current alerts
lastCheckin
DateTime
Timestamp of last check-in
lastDeviceSettingUpdatedOn
DateTime
Date and time stamp of the last device setting change request
batteryRemaining
Integer
Battery life remaining as a percentage
isRegistered
Boolean
True/false if the device is registered
hasDeviceCheckedIn
Boolean
True/false if the device has checked-in to Resideo servers.
isDeviceOffline
Boolean
True/false if the device is offline.
firstFailedAttemptTime
DateTime
failedConnectionAttempts
Integer
wifiSignalStrength
Integer
WiFi signal strength in db
isFirmwareUpdateRequired
Boolean
Does the device require a firmware update
time
DateTime
deviceClass
String
Class of the device. "LeakDetector" for Water Leak Detector.
deviceType
String
Type of the device. "Water Leak Detector" for Water Leak Detector devices.
deviceID
String
Unique device ID
userDefinedDeviceName
String
User defined device name, what is shown in the Honeywell Home App
backend
Object
backend.id
String
Backend device ID
isAlive
Boolean
Is the device online or not.
isUpgrading
Boolean
Is the device currently running a firmware update?
isProvisioned
Boolean
Is the device provisioned correctly?
deviceSettings.temp
Object
Temperature limit settings for alerts
deviceSettings.temp.high
Object
deviceSettings.temp.high.limit
Decimal
The device reading this temp will cause a high temperature alert. Always in C units.
deviceSettings.temp.low
Object
deviceSettings.temp.low.limit
Decimal
The device reading this temp will cause a low temperature alert. Always in C units.
deviceSettings.humidity
Object
Temperature limit settings for alerts
deviceSettings.humidity.high
Object
deviceSettings.humidity.high.limit
Percentage
The device reading this humidity will cause a high humidity alert.
deviceSettings.humidity.low
Object
deviceSettings.humidity.low.limit
Percentage
The device reading this humidity will cause a low humidity alert.
deviceSettings.humidity
Object
Humidity limit settings for alerts
deviceSettings.userDefinedName
String
User defined device name
deviceSettings.buzzerMuted
Boolean
Buzzer muted true/false
deviceSettings.checkinPeriod
Integer
User set device check-in/reporting period for periodic readings
deviceSettings.currentSensorReadPeriod
Integer
Sensor reading period
{
"model": "C2",
"manufacturer": "Edimax",
"serial": "1726ZA300023",
"maxResolution": "1920x1080",
"firmwareVer": "v1.26_20171017",
"wifiStrength": "54",
"deviceClass": "Camera",
"deviceType": "C2",
"deviceID": "c7a4c930-ef20-48ee-b8a4-74e4b4152ef8",
"userDefinedDeviceName": "Camera",
"isAlive": true,
"isUpgrading": false,
"isProvisioned": true,
"macID": "74DA38D20850"
}
Field Name/Location
Data Type
Definition
model
String
Camera model
manufacturer
String
Camera manufacturer
serial
String
Camera serial number
maxResolution
String
Max display resoultion of the camera (WxH)
firmwareVer
String
Current firmware version
wifiStrength
Integer
Wifi signal strength
deviceClass
String
Class of device. "Camera" for cameras
deviceType
String
Type of camera (C1, C2, etc)
deviceID
String
Unique Device ID
userDefinedDeviceName
String
User defined device name. Shown in the Honeywell Home App.
isAlive
Boolean
Is the device online or not?
isUpgrading
Boolean
Is the device currently performing a firmware update?
isProvisioned
Boolean
Is the device provisioned correctly?
macID
Unique MACID of the device
GET
Get all Devices by Type
https://api.honeywell.com/v2/devices/{deviceType}
Use this method to get all devices of a specific type by locationId.
Valid device types for URI: "thermostats", "waterLeakDetectors", and "cameras".
Actual responses will differ based on specific device, equipment setup, and model type.
Response Model for ThermostatResponse Model for Water Leak DetectorResponse Model for Camera
Data Definitions for ThermostatData Definitions for Water Leak DetectorData Definitions for Camera
{
"displayedOutdoorHumidity": 67,
"vacationHold": {
"enabled": false
},
"currentSchedulePeriod": {
"day": "Thursday",
"period": "Away"
},
"scheduleCapabilities": {
"availableScheduleTypes": [
"None",
"Geofenced",
"TimedNorthAmerica"
],
"schedulableFan": false
},
"scheduleType": {
"scheduleType": "Timed",
"scheduleSubType": "NA"
},
"scheduleStatus": "Resume",
"allowedTimeIncrements": 15,
"settings": {
"hardwareSettings": {
"brightness": 0,
"maxBrightness": 5
},
"fan": {
"allowedModes": [
"On",
"Auto",
"Circulate"
],
"changeableValues": {
"mode": "On"
}
},
"temperatureMode": {
"air": true
},
"specialMode": {
"autoChangeoverActive": false,
"emergencyHeatActive": false
}
},
"deviceClass": "Thermostat",
"deviceType": "Thermostat",
"deviceID": "LCC-00D02DAB5CBE",
"userDefinedDeviceName": "TSeries",
"name": "TSeries",
"isAlive": true,
"isUpgrading": false,
"isProvisioned": true,
"macID": "00D02DAB5CBE",
"deviceSettings": {},
"units": "Fahrenheit",
"indoorTemperature": 73,
"outdoorTemperature": 46,
"allowedModes": [
"EmergencyHeat",
"Heat",
"Off",
"Cool",
"Auto"
],
"deadband": 0,
"hasDualSetpointStatus": false,
"minHeatSetpoint": 50,
"maxHeatSetpoint": 90,
"minCoolSetpoint": 50,
"maxCoolSetpoint": 90,
"changeableValues": {
"mode": "Heat",
"autoChangeoverActive": false,
"emergencyHeatActive": false,
"heatSetpoint": 62,
"coolSetpoint": 85,
"thermostatSetpointStatus": "NoHold",
"nextPeriodTime": "18:00:00",
"endHeatSetpoint": 62,
"endCoolSetpoint": 85,
"heatCoolMode": "Heat"
},
"operationStatus": {
"mode": "EquipmentOff",
"fanRequest": false,
"circulationFanRequest": false
}
}
Field Name/Location
Data Type
Definition
displayedOutdoorHumidity
Integer
Outdoor humidity reading (from weather data), should be treated as percentage
vacationHold
Object
vacationHold.enabled
Boolean
Is vacation hold enabled?
scheduleCapabilities
Object
scheduleCapabilities.availableScheduleTypes
Array
List of available schedule types
scheduleCapabilities.schedulableFan
Boolean
Is the fan mode scheduleable?
scheduleType
Object
scheduleType.scheduleType
String
Current schedule type
scheduleType.scheduleSubType
String
Current schedule sub-type
scheduleStatus
String
Current status of schedule
allowedTimeIncrements
Integer
Allowed time increments of the timed schedule (in minutes)
settings
Object
settings.hardwareSettings
Object
settings.hardwareSettings.brightness
Integer
Current brightness setting
settings.hardwareSettings.maxBrightness
Integer
Maximum brightness setting
settings.fan
Object
settings.fan.allowedModes
Array
Array of allowed fan modes
settings.fan.changeableValues
Object
List of writeable fan settings
settings.temperatureMode
Object
settings.temperatureMode.air
Boolean
settings.specialMode
Object
settings.specialMode.autoChangeoverActive
Boolean
Will exist if device has this mode enabled, true or false based on running in that mode
settings.specialMode.emergencyHeatActive
Boolean
Will exist if device has this mode enabled, true or false based on running in that mode
deviceClass
String
Class of device
deviceType
String
Type of device
deviceID
String
Unique ID of device. "LCC-" == T-Series, "TCC-" == Honeywell Home Round
userDefinedDeviceName
String
User defined name of the device. Shown in the mobile app.
name
String
Device name
isAlive
Boolean
true == device online. false == device offline
isProvisioned
Boolean
Is the device provisioned correctly or not
macID
String
Unique MACID of the device
deviceSettings
Object
units
String
Units used on device (Celsius or Fahrenheit)
indoorTemperature
Integer or Float
Current display temperature on device. Whole numbers for F units or .5 increments for C units.
outdoorTemperature
Integer or Float
Current outdoor temperature based on location data.
allowedModes
Array
List of allowed modes for the device, also be sure to doublecheck settings.specialMode for Round.
deadband
Integer
Required separation between high and low setpoints. Default for Thermostats is 0.
hasDualSetpointStatus
Boolean
Indicates whether the thermostat maintains separate heat and cool setpoint status value.
minHeatSetpoint
Integer or Float
The lower limit for the heating setpoint.
maxHeatSetpoint
Integer or Float
The upper limit for the heating setpoint.
minCoolSetpoint
Integer or Float
The lower limit for the heating setpoint.
maxCoolSetpoint
Integer or Float
The upper limit for the heating setpoint.
changeableValues.mode
String
Current mode of the thermostat.
changeableValues.autoChangeoverActive
Boolean
If field is set in the response then the thermostat supports autochangeover to be controlled independent of mode. If field is not set in the response then the thermostat does not support autochangeover.
changeableValues.emergencyHeatActive
Boolean
Indicates if emergency heating is active. When this field is returned (it is nullable and does not have to be in the response) - it means that the device handles emergency heating independently of the mode. When this field is returned (it is nullable and does not have to be in the response) - device will not accept EmergencyHeat as an allowed value. When emergency heating is active you cannot set thermostat's mode to other value than Off and you cannot change autochangeover.
changeableValues.heatSetpoint
Decimal
Current heating setpoint.
changeableValues.coolSetpoint
Decimal
Current cooling setpoint.
changeableValues.thermostatSetpointStatus
String
Signifies current setpoint state. TemporaryHold, HoldUntil, PermanentHold, VacationHold, NoHold
changeableValues.holdUntil
timeSpan
Time in 15 minutes intervals (the maximum value is 92 = 11:45 PM), meaning depends on other properties.
changeableValues.nextPeriodTime
timeSpan
Indicates when next schedule period starts
changeableValues.endHeatSetpoint
Decimal
The heating setpoint that would occur if the current hold ended now. If there is no hold, or if the thermostat cannot control heating, then this value is not present.
changeableValues.endCoolSetpoint
Decimal
The cooling setpoint that would occur if the current hold ended now. If there is no hold, or if the thermostat cannot control cooling, then this value is not present.
changeableValues.heatCoolMode
String
Heat cool mode when system switch is in Auto mode.
operationStatus
Object
Details around operation status of the equipment.
operationStatus.mode
String
Current running (relay status) of the equipment.
operationStatus.fanRequest
Boolean
Current running (relay status) of the fan.
operationStatus.circulationFanRequest
Boolean
Current running (relay status) of the fan circulate mode.
smartAway
Object
Settings that will take effect when nobody is home (via Geofencing). Null when reported means smart away is not available.
indoorHumidity
Decimal
Indoor humidity rating as a percentage, if available
indoorHumidityStatus
String
Status of humidity sensor. Measured, NotAvailable, or SensorFault.
{
"firmwareVer": "0.5.16A4",
"waterPresent": false,
"currentSensorReadings": {
"time": "2017-10-19T08:27:42",
"temperature": 20.39,
"humidity": 44.8
},
"currentAlarms": [],
"lastCheckin": "2017-10-19T08:27:44",
"lastDeviceSettingUpdatedOn": "0001-01-01T00:00:00",
"batteryRemaining": 43,
"isRegistered": true,
"hasDeviceCheckedIn": true,
"isDeviceOffline": false,
"firstFailedAttemptTime": "0001-01-01T00:00:00",
"failedConnectionAttempts": 0,
"wifiSignalStrength": -46,
"isFirmwareUpdateRequired": false,
"time": "2017-10-19T08:27:42",
"deviceClass": "LeakDetector",
"deviceType": "Water Leak Detector",
"deviceID": "31aae686-6b4a-476e-8cbc-da4a1cab2cd5",
"userDefinedDeviceName": "Basement",
"backend": {
"id": "31aae686-6b4a-476e-8cbc-da4a1cab2cd5"
},
"isAlive": true,
"isUpgrading": false,
"isProvisioned": true,
"deviceSettings": {
"temp": {
"high": {
"limit": 36.5
},
"low": {
"limit": 6.5
}
},
"humidity": {
"high": {
"limit": 70
},
"low": {
"limit": 20
}
},
"userDefinedName": "Basement",
"buzzerMuted": false,
"checkinPeriod": 8,
"currentSensorReadPeriod": 60
}
}
Field Name/Location
Data Type
Definition
firmwareVer
String
Current firmware version
waterPresent
Boolean
True if water has been detected
currentSensorReadings
Object
currentSensorReadings.time
DateTime
Timestamp of last reading
currentSensorReadings.temperature
Decimal
Last read temperature, always in C units
currentSensorReadings.humidity
Percentage
Last read humidity, always a percentage
currentAlarms
Object Array
Array of objects for current alerts
lastCheckin
DateTime
Timestamp of last check-in
lastDeviceSettingUpdatedOn
DateTime
Date and time stamp of the last device setting change request
batteryRemaining
Integer
Battery life remaining as a percentage
isRegistered
Boolean
True/false if the device is registered
hasDeviceCheckedIn
Boolean
True/false if the device has checked-in to Resideo servers.
isDeviceOffline
Boolean
True/false if the device is offline.
firstFailedAttemptTime
DateTime
failedConnectionAttempts
Integer
wifiSignalStrength
Integer
WiFi signal strength in db
isFirmwareUpdateRequired
Boolean
Does the device require a firmware update
time
DateTime
deviceClass
String
Class of the device. "LeakDetector" for Water Leak Detector.
deviceType
String
Type of the device. "Water Leak Detector" for Water Leak Detector devices.
deviceID
String
Unique device ID
userDefinedDeviceName
String
User defined device name, what is shown in the Honeywell Home App
backend
Object
backend.id
String
Backend device ID
isAlive
Boolean
Is the device online or not.
isUpgrading
Boolean
Is the device currently running a firmware update?
isProvisioned
Boolean
Is the device provisioned correctly?
deviceSettings.temp
Object
Temperature limit settings for alerts
deviceSettings.temp.high
Object
deviceSettings.temp.high.limit
Decimal
The device reading this temp will cause a high temperature alert. Always in C units.
deviceSettings.temp.low
Object
deviceSettings.temp.low.limit
Decimal
The device reading this temp will cause a low temperature alert. Always in C units.
deviceSettings.humidity
Object
Temperature limit settings for alerts
deviceSettings.humidity.high
Object
deviceSettings.humidity.high.limit
Percentage
The device reading this humidity will cause a high humidity alert.
deviceSettings.humidity.low
Object
deviceSettings.humidity.low.limit
Percentage
The device reading this humidity will cause a low humidity alert.
deviceSettings.humidity
Object
Humidity limit settings for alerts
deviceSettings.userDefinedName
String
User defined device name
deviceSettings.buzzerMuted
Boolean
Buzzer muted true/false
deviceSettings.checkinPeriod
Integer
User set device check-in/reporting period for periodic readings
deviceSettings.currentSensorReadPeriod
Integer
Sensor reading period
{
"model": "C2",
"manufacturer": "Edimax",
"serial": "1726ZA300023",
"maxResolution": "1920x1080",
"firmwareVer": "v1.26_20171017",
"wifiStrength": "54",
"deviceClass": "Camera",
"deviceType": "C2",
"deviceID": "c7a4c930-ef20-48ee-b8a4-74e4b4152ef8",
"userDefinedDeviceName": "Camera",
"isAlive": true,
"isUpgrading": false,
"isProvisioned": true,
"macID": "74DA38D20850"
}
Field Name/Location
Data Type
Definition
model
String
Camera model
manufacturer
String
Camera manufacturer
serial
String
Camera serial number
maxResolution
String
Max display resoultion of the camera (WxH)
firmwareVer
String
Current firmware version
wifiStrength
Integer
Wifi signal strength
deviceClass
String
Class of device. "Camera" for cameras
deviceType
String
Type of camera (C1, C2, etc)
deviceID
String
Unique Device ID
userDefinedDeviceName
String
User defined device name. Shown in the Honeywell Home App.
isAlive
Boolean
Is the device online or not?
isUpgrading
Boolean
Is the device currently performing a firmware update?
isProvisioned
Boolean
Is the device provisioned correctly?
macID
Unique MACID of the device
GET
Get all devices for a location
https://api.honeywell.com/v2/devices
Return all devices in a particular locationID.
Response Model for ThermostatData Definitions for Thermostat
Response Model for Water Leak DetectorData Definitions for Water Leak Detector
Response Model for CameraData Definitions for Camera
Response Model for Smart Home SecurityData Definitions for Smart Home Security
{
"displayedOutdoorHumidity": 67,
"vacationHold": {
"enabled": false
},
"currentSchedulePeriod": {
"day": "Thursday",
"period": "Away"
},
"scheduleCapabilities": {
"availableScheduleTypes": [
"None",
"Geofenced",
"TimedNorthAmerica"
],
"schedulableFan": false
},
"scheduleType": {
"scheduleType": "Timed",
"scheduleSubType": "NA"
},
"scheduleStatus": "Resume",
"allowedTimeIncrements": 15,
"settings": {
"hardwareSettings": {
"brightness": 0,
"maxBrightness": 5
},
"fan": {
"allowedModes": [
"On",
"Auto",
"Circulate"
],
"changeableValues": {
"mode": "On"
}
},
"temperatureMode": {
"air": true
},
"specialMode": {
"autoChangeoverActive": false,
"emergencyHeatActive": false
}
},
"deviceClass": "Thermostat",
"deviceType": "Thermostat",
"deviceID": "LCC-00D02DAB5CBE",
"userDefinedDeviceName": "TSeries",
"name": "TSeries",
"isAlive": true,
"isUpgrading": false,
"isProvisioned": true,
"macID": "00D02DAB5CBE",
"deviceSettings": {},
"units": "Fahrenheit",
"indoorTemperature": 73,
"outdoorTemperature": 46,
"allowedModes": [
"EmergencyHeat",
"Heat",
"Off",
"Cool",
"Auto"
],
"deadband": 0,
"hasDualSetpointStatus": false,
"minHeatSetpoint": 50,
"maxHeatSetpoint": 90,
"minCoolSetpoint": 50,
"maxCoolSetpoint": 90,
"changeableValues": {
"mode": "Heat",
"autoChangeoverActive": false,
"emergencyHeatActive": false,
"heatSetpoint": 62,
"coolSetpoint": 85,
"thermostatSetpointStatus": "NoHold",
"nextPeriodTime": "18:00:00",
"endHeatSetpoint": 62,
"endCoolSetpoint": 85,
"heatCoolMode": "Heat"
},
"operationStatus": {
"mode": "EquipmentOff",
"fanRequest": false,
"circulationFanRequest": false
}
}
Field Name/Location
Data Type
Definition
displayedOutdoorHumidity
Integer
Outdoor humidity reading (from weather data), should be treated as percentage
vacationHold
Object
vacationHold.enabled
Boolean
Is vacation hold enabled?
scheduleCapabilities
Object
scheduleCapabilities.availableScheduleTypes
Array
List of available schedule types
scheduleCapabilities.schedulableFan
Boolean
Is the fan mode scheduleable?
scheduleType
Object
scheduleType.scheduleType
String
Current schedule type
scheduleType.scheduleSubType
String
Current schedule sub-type
scheduleStatus
String
Current status of schedule
allowedTimeIncrements
Integer
Allowed time increments of the timed schedule (in minutes)
settings
Object
settings.hardwareSettings
Object
settings.hardwareSettings.brightness
Integer
Current brightness setting
settings.hardwareSettings.maxBrightness
Integer
Maximum brightness setting
settings.fan
Object
settings.fan.allowedModes
Array
Array of allowed fan modes
settings.fan.changeableValues
Object
List of writeable fan settings
settings.temperatureMode
Object
settings.temperatureMode.air
Boolean
settings.specialMode
Object
settings.specialMode.autoChangeoverActive
Boolean
Will exist if device has this mode enabled, true or false based on running in that mode
settings.specialMode.emergencyHeatActive
Boolean
Will exist if device has this mode enabled, true or false based on running in that mode
deviceClass
String
Class of device
deviceType
String
Type of device
deviceID
String
Unique ID of device. "LCC-" == T-Series, "TCC-" == Round
userDefinedDeviceName
String
User defined name of the device. Shown in the mobile app.
name
String
Device name
isAlive
Boolean
true == device online. false == device offline
isProvisioned
Boolean
Is the device provisioned correctly or not
macID
String
Unique MACID of the device
deviceSettings
Object
units
String
Units used on device (Celsius or Fahrenheit)
indoorTemperature
Integer or Float
Current display temperature on device. Whole numbers for F units or .5 increments for C units.
outdoorTemperature
Integer or Float
Current outdoor temperature based on location data.
allowedModes
Array
List of allowed modes for the device, also be sure to doublecheck settings.specialMode for Round.
deadband
Integer
Required separation between high and low setpoints. Default for Thermostats is 0.
hasDualSetpointStatus
Boolean
Indicates whether the thermostat maintains separate heat and cool setpoint status value.
minHeatSetpoint
Integer or Float
The lower limit for the heating setpoint.
maxHeatSetpoint
Integer or Float
The upper limit for the heating setpoint.
minCoolSetpoint
Integer or Float
The lower limit for the heating setpoint.
maxCoolSetpoint
Integer or Float
The upper limit for the heating setpoint.
changeableValues.mode
String
Current mode of the thermostat.
changeableValues.autoChangeoverActive
Boolean
If field is set in the response then the thermostat supports autochangeover to be controlled independent of mode. If field is not set in the response then the thermostat does not support autochangeover.
changeableValues.emergencyHeatActive
Boolean
Indicates if emergency heating is active. When this field is returned (it is nullable and does not have to be in the response) - it means that the device handles emergency heating independently of the mode. When this field is returned (it is nullable and does not have to be in the response) - device will not accept EmergencyHeat as an allowed value. When emergency heating is active you cannot set thermostat's mode to other value than Off and you cannot change autochangeover.
changeableValues.heatSetpoint
Decimal
Current heating setpoint.
changeableValues.coolSetpoint
Decimal
Current cooling setpoint.
changeableValues.thermostatSetpointStatus
String
Signifies current setpoint state. TemporaryHold, HoldUntil, PermanentHold, VacationHold, NoHold
changeableValues.holdUntil
timeSpan
Time in 15 minutes intervals (the maximum value is 92 = 11:45 PM), meaning depends on other properties.
changeableValues.nextPeriodTime
timeSpan
Indicates when next schedule period starts
changeableValues.endHeatSetpoint
Decimal
The heating setpoint that would occur if the current hold ended now. If there is no hold, or if the thermostat cannot control heating, then this value is not present.
changeableValues.endCoolSetpoint
Decimal
The cooling setpoint that would occur if the current hold ended now. If there is no hold, or if the thermostat cannot control cooling, then this value is not present.
changeableValues.heatCoolMode
String
Heat cool mode when system switch is in Auto mode.
operationStatus
Object
Details around operation status of the equipment.
operationStatus.mode
String
Current running (relay status) of the equipment.
operationStatus.fanRequest
Boolean
Current running (relay status) of the fan.
operationStatus.circulationFanRequest
Boolean
Current running (relay status) of the fan circulate mode.
smartAway
Object
Settings that will take effect when nobody is home (via Geofencing). Null when reported means smart away is not available.
indoorHumidity
Decimal
Indoor humidity rating as a percentage, currently only on Round thermostats
indoorHumidityStatus
String
Status of humidity sensor. Measured, NotAvailable, or SensorFault.
{
"firmwareVer": "0.5.16A4",
"waterPresent": false,
"currentSensorReadings": {
"time": "2017-10-19T08:27:42",
"temperature": 20.39,
"humidity": 44.8
},
"currentAlarms": [],
"lastCheckin": "2017-10-19T08:27:44",
"lastDeviceSettingUpdatedOn": "0001-01-01T00:00:00",
"batteryRemaining": 43,
"isRegistered": true,
"hasDeviceCheckedIn": true,
"isDeviceOffline": false,
"firstFailedAttemptTime": "0001-01-01T00:00:00",
"failedConnectionAttempts": 0,
"wifiSignalStrength": -46,
"isFirmwareUpdateRequired": false,
"time": "2017-10-19T08:27:42",
"deviceClass": "LeakDetector",
"deviceType": "Water Leak Detector",
"deviceID": "31aae686-6b4a-476e-8cbc-da4a1cab2cd5",
"userDefinedDeviceName": "Basement",
"backend": {
"id": "31aae686-6b4a-476e-8cbc-da4a1cab2cd5"
},
"isAlive": true,
"isUpgrading": false,
"isProvisioned": true,
"deviceSettings": {
"temp": {
"high": {
"limit": 36.5
},
"low": {
"limit": 6.5
}
},
"humidity": {
"high": {
"limit": 70
},
"low": {
"limit": 20
}
},
"userDefinedName": "Basement",
"buzzerMuted": false,
"checkinPeriod": 8,
"currentSensorReadPeriod": 60
}
}
Field Name/Location
Data Type
Definition
firmwareVer
String
Current firmware version
waterPresent
Boolean
True if water has been detected
currentSensorReadings
Object
currentSensorReadings.time
DateTime
Timestamp of last reading
currentSensorReadings.temperature
Decimal
Last read temperature, always in C units
currentSensorReadings.humidity
Percentage
Last read humidity, always a percentage
currentAlarms
Object Array
Array of objects for current alerts
lastCheckin
DateTime
Timestamp of last check-in
lastDeviceSettingUpdatedOn
DateTime
Date and time stamp of the last device setting change request
batteryRemaining
Integer
Battery life remaining as a percentage
isRegistered
Boolean
True/false if the device is registered
hasDeviceCheckedIn
Boolean
True/false if the device has checked-in to Resideo servers.
isDeviceOffline
Boolean
True/false if the device is offline.
firstFailedAttemptTime
DateTime
failedConnectionAttempts
Integer
wifiSignalStrength
Integer
WiFi signal strength in db
isFirmwareUpdateRequired
Boolean
Does the device require a firmware update
time
DateTime
deviceClass
String
Class of the device. "LeakDetector" for Water Leak Detector.
deviceType
String
Type of the device. "Water Leak Detector" for Water Leak Detector devices.
deviceID
String
Unique device ID
userDefinedDeviceName
String
User defined device name, what is shown in the Honeywell Home App
backend
Object
backend.id
String
Backend device ID
isAlive
Boolean
Is the device online or not.
isUpgrading
Boolean
Is the device currently running a firmware update?
isProvisioned
Boolean
Is the device provisioned correctly?
deviceSettings.temp
Object
Temperature limit settings for alerts
deviceSettings.temp.high
Object
deviceSettings.temp.high.limit
Decimal
The device reading this temp will cause a high temperature alert. Always in C units.
deviceSettings.temp.low
Object
deviceSettings.temp.low.limit
Decimal
The device reading this temp will cause a low temperature alert. Always in C units.
deviceSettings.humidity
Object
Temperature limit settings for alerts
deviceSettings.humidity.high
Object
deviceSettings.humidity.high.limit
Percentage
The device reading this humidity will cause a high humidity alert.
deviceSettings.humidity.low
Object
deviceSettings.humidity.low.limit
Percentage
The device reading this humidity will cause a low humidity alert.
deviceSettings.humidity
Object
Humidity limit settings for alerts
deviceSettings.userDefinedName
String
User defined device name
deviceSettings.buzzerMuted
Boolean
Buzzer muted true/false
deviceSettings.checkinPeriod
Integer
User set device check-in/reporting period for periodic readings
deviceSettings.currentSensorReadPeriod
Integer
Sensor reading period
{
"model": "C2",
"manufacturer": "Edimax",
"serial": "1726ZA300023",
"maxResolution": "1920x1080",
"firmwareVer": "v1.26_20171017",
"wifiStrength": "54",
"deviceClass": "Camera",
"deviceType": "C2",
"deviceID": "c7a4c930-ef20-48ee-b8a4-74e4b4152ef8",
"userDefinedDeviceName": "Camera",
"isAlive": true,
"isUpgrading": false,
"isProvisioned": true,
"macID": "74DA38D20850"
}
Field Name/Location
Data Type
Definition
model
String
Camera model
manufacturer
String
Camera manufacturer
serial
String
Camera serial number
maxResolution
String
Max display resoultion of the camera (WxH)
firmwareVer
String
Current firmware version
wifiStrength
Integer
Wifi signal strength
deviceClass
String
Class of device. "Camera" for cameras
deviceType
String
Type of camera (C1, C2, etc)
deviceID
String
Unique Device ID
userDefinedDeviceName
String
User defined device name. Shown in the Honeywell Home App.
isAlive
Boolean
Is the device online or not?
isUpgrading
Boolean
Is the device currently performing a firmware update?
isProvisioned
Boolean
Is the device provisioned correctly?
macID
Unique MACID of the device
{
"deviceDetails": {
"configurations": {
"model": "DAS",
"firmwareVersion": "HDAS_GL.1.2.006.0091",
"commApiVersion": "1.0.0.1",
"mac": "B82CA0032222",
"serialNumber": "0x956D1AC8\n",
"wifiInfo": {
"name": "HCH_A1"
},
"firmwareUpgradeInfo": {
"lastSuccessfulUpgradeTime": "2018-10-03T12:29:26.3828809Z",
"lastUpgradeStartTime": "2018-10-03T12:25:15.3624593Z",
"expectedUpgradeCompletionTime": "2018-10-03T12:33:15.3624593Z"
},
"primaryZWaveController": {
"id": "1",
"name": "SUC/SIS Controller",
"configurations": {
"version": "C07,0500 (4.61)",
"homeId": "c533d2be",
"type": "SucSis",
"nodeId": "1",
"nodeDescription": "SUC/SIS Controller",
"automationDeviceType": "Output",
"automationDeviceSubType": "Controller",
"manufacturerName": "Honeywell ",
"manufacturerId": "Controller",
"productId": "1",
"productType": "8",
"routerCapability": false,
"associationState": false,
"deviceSecurity": true,
"specificType": 10,
"securityMode": "Wep"
},
"state": {
"value": 0,
"isConnected": true,
"inReplaceMode": false
}
},
"voiceCommands": [
{
"voiceEngine": "Alexa",
"enabled": true
}
]
},
"state": {
"isACLoss": false,
"batteryState": {
"isLow": false,
"level": 100
},
"isTampered": false,
"isOnline": true,
"discoveryMode": "Disable",
"lastCommunicationStatusChange": "2019-04-03T20:15:55.3498069Z",
"isSyncInProgress": false,
"isUpgradeInProgress": false,
"alexaConnectionState": "Disconnect",
"isMandatoryFirmwareUpgradeRequired": false
},
"partitions": [
{
"id": "1",
"name": "Lyric Home",
"configurations": {
"canRestartTimer": false,
"entryDelay": 15,
"exitDelay": 15,
"enableDeterrence": false,
"setStateConfigs": [
{
"setState": "Disarm",
"enableAlarm": false,
"enableCamera": false,
"chimeVolume": 22,
"enableDeterrence": false,
"enableOsmv": false
},
{
"setState": "ArmAway",
"enableAlarm": true,
"enableCamera": true,
"chimeVolume": 22,
"enableDeterrence": false,
"enableOsmv": true
},
{
"setState": "ArmStay",
"enableAlarm": true,
"enableCamera": false,
"chimeVolume": 22,
"enableDeterrence": false,
"enableOsmv": true
}
],
"deterrenceActions": {
"chimes": [
"DogBark"
]
}
},
"state": {
"setState": "Disarm",
"inEntryDelay": false,
"inExitDelay": false,
"alarmState": "None",
"isTrouble": false,
"isFault": true,
"isBypassed": false,
"lastUpdatedTime": "2019-04-17T17:40:26.8661883Z",
"silentModeEnabled": true,
"lastSetStateUpdatedTime": "2019-04-17T17:40:26.8661883Z"
}
}
],
"sensors": [
{
"id": "3",
"name": "Living Room Window",
"configurations": {
"firmwareVersion": "06155A35",
"serialNumber": "306184470:1",
"bridgeId": "3",
"sensitivity": 0,
"chime": "Standard",
"isEnabled": true,
"sensorCommType": "Unknown",
"responseType": "Perimeter",
"sensorType": "Input",
"sensorSubType": "Contact"
},
"state": {
"isAlarm": false,
"isBypassed": false,
"isFault": true,
"isTrouble": false,
"isTampered": false,
"supervisionFailed": false,
"isEnrolled": true,
"isConnected": true,
"signalStrength": 0,
"batteryState": {
"isLow": false,
"level": 0
},
"activeTests": [],
"isVerified": false
}
},
{
"id": "2",
"name": "Front Door",
"configurations": {
"firmwareVersion": "06155A35",
"serialNumber": "306184545:1",
"bridgeId": "2",
"sensitivity": 0,
"chime": "Standard",
"isEnabled": true,
"sensorCommType": "Unknown",
"responseType": "EntryExit",
"sensorType": "Input",
"sensorSubType": "Contact"
},
"state": {
"isAlarm": false,
"isBypassed": false,
"isFault": true,
"isTrouble": false,
"isTampered": false,
"supervisionFailed": false,
"isEnrolled": true,
"isConnected": true,
"signalStrength": 0,
"batteryState": {
"isLow": false,
"level": 0
},
"activeTests": [],
"isVerified": false
}
},
{
"id": "4",
"name": "Front Porch",
"configurations": {
"firmwareVersion": "09215B13",
"serialNumber": "1128923551:1",
"bridgeId": "4",
"sensitivity": 0,
"chime": "Standard",
"isEnabled": true,
"sensorCommType": "Unknown",
"responseType": "NoResponse",
"sensorType": "Pir",
"sensorSubType": "Osmv"
},
"state": {
"isAlarm": false,
"isBypassed": false,
"isFault": false,
"isTrouble": false,
"isTampered": false,
"supervisionFailed": false,
"isEnrolled": true,
"isConnected": true,
"signalStrength": 0,
"batteryState": {
"isLow": false,
"level": 0
},
"activeTests": [],
"isVerified": false
}
}
],
"keyFobs": [
{
"id": "131",
"name": "Fob1",
"partitionId": "1",
"configurations": {
"serialNumber": "306708788:0",
"size": 0,
"firmwareVersion": "07155A4B"
},
"state": {
"keyCommandMapping": [
{
"keyIndex": 131,
"commandIndex": 21
},
{
"keyIndex": 132,
"commandIndex": 22
},
{
"keyIndex": 133,
"commandIndex": 20
},
{
"keyIndex": 134,
"commandIndex": 7
}
],
"isEnrolled": true,
"batteryState": {
"isLow": false,
"level": 60
},
"signalStrength": 0
}
}
],
"automationDevices": {
"switches": [
{
"configurations": {
"switchType": "Dimmer",
"switchSubType": "Default",
"nodeId": "2",
"nodeDescription": "Switch 001",
"automationDeviceType": "Output",
"automationDeviceSubType": "Switch Multilevel",
"manufacturerName": "Honeywell Multi Mode Comm., 5044, 3033",
"manufacturerId": "Switch Multilevel",
"productId": "3033",
"productType": "5044",
"routerCapability": false,
"associationState": false,
"deviceSecurity": false,
"specificType": 2,
"securityMode": "Open"
},
"state": {
"lastCommunicationStatusChangeTime": "2019-02-26T22:17:03.9144634Z",
"value": 0,
"isConnected": false,
"inReplaceMode": false
},
"id": "AD_1",
"name": "Outlet"
},
{
"configurations": {
"switchType": "Toggle",
"switchSubType": "Default",
"nodeId": "3",
"nodeDescription": "Switch 002",
"automationDeviceType": "Output",
"automationDeviceSubType": "Switch Binary",
"manufacturerName": "Jasco Products Multi Mode Comm., 5052, 3039",
"manufacturerId": "Switch Binary",
"productId": "3039",
"productType": "5052",
"routerCapability": false,
"associationState": false,
"deviceSecurity": false,
"specificType": 1,
"securityMode": "Open"
},
"state": {
"lastCommunicationStatusChangeTime": "2019-03-06T20:08:16.0600441Z",
"value": 1,
"isConnected": false,
"inReplaceMode": false
},
"id": "AD_2",
"name": "Printer"
},
{
"configurations": {
"switchType": "Dimmer",
"switchSubType": "Default",
"nodeId": "4",
"nodeDescription": "Switch 003",
"automationDeviceType": "Output",
"automationDeviceSubType": "Switch Multilevel",
"manufacturerName": "Jasco Products Multi Mode Comm., 4C42, 3031",
"manufacturerId": "Switch Multilevel",
"productId": "3031",
"productType": "4c42",
"routerCapability": false,
"associationState": false,
"deviceSecurity": false,
"specificType": 2,
"securityMode": "Open"
},
"state": {
"lastCommunicationStatusChangeTime": "2019-04-01T19:59:15.518994Z",
"value": 99,
"isConnected": true,
"inReplaceMode": false
},
"id": "AD_3",
"name": "Lamp"
}
]
},
"onboardDevices": [
{
"deviceClass": "Camera",
"deviceType": "BuiltIn",
"deviceID": "21034",
"maxResolution": "1920x1080",
"manufacturer": "Honeywell Technology Solutions Pvt Ltd",
"model": "HONDASCP100",
"serial": "111122223333",
"firmwareVer": "90",
"macID": "B8:2C:A0:03:22:22",
"userDefinedDeviceName": "Living Room",
"isAlive": true,
"isUpgrading": false,
"isProvisioned": true,
"wifiStrength": "",
"backend": "EMX",
"peopleDetectionState": "None"
}
]
},
"geoFence": "off",
"frConfiguration": {
"maxPersons": 2,
"plan": "Free"
},
"deviceClass": "DeviceGateway",
"deviceType": "HONDAS",
"deviceID": "LSC-B82CA0032222",
"userDefinedDeviceName": "Security",
"name": "Security",
"isAlive": true,
"isProvisioned": true,
"macID": "B82CA0032222",
"deviceSettings": {},
"service": {
"mode": "Up"
}
}
Field Name/Location
Data Type
Definition
deviceDetails
Object
Object with collection of device details
deviceDetails.configurations
Object
Configuration object
deviceDetails.configurations.model
String
Device Model, should be "DAS"
deviceDetails.configurations.firmwareVersion
String
Current firmware version
deviceDetails.configurations.mac
String
MacID
deviceDetails.configurations.wifiInfo.name
String
Current Wifi SSID used
deviceDetails.configurations.voiceCommands
Array
Array of voice assistant configurations
deviceDetails.configurations.voiceCommands.voiceEngine
String
Name of voice engine
deviceDetails.configurations.voiceCommands.enabled
Boolean
Is the assistant enabled
deviceDetails.state
Object
Base station state object
deviceDetails.state.isACLoss
Boolean
Is device plugged in? False means device is using AC power
deviceDetails.state.batteryState
Object
Battery state info
deviceDetails.state.batteryState.isLow
Boolean
Is battery level low?
deviceDetails.state.batteryState.level
Integer
Battery level, in percentage
deviceDetails.state.isTampered
Boolean
Is the device tamper detection activated?
deviceDetails.state.isOnline
Boolean
Is the device online?
deviceDetails.state.discoveryMode
String
Is the device currently in Z-Wave discovery mode?
deviceDetails.state.lasCommunicationStateChange
DateTime
Last time the isOnline state changed in UTC
deviceDetails.state.isSyncInProgress
Boolean
Is device sync in progress?
deviceDetails.state.isUpgradeInProgress
Boolean
Is the device firmware currently being updated?
deviceDetails.state.alexaConnectionState
String
Is Alexa connected or not?
deviceDetails.partitions
Array
Array of partitions configured
deviceDetails.partitions.id
String
ID of partition, used when arming and disarming
deviceDetails.partitions.name
String
Name of partition
deviceDetails.partitions.configurations
Object
Partition configuration info
deviceDetails.partitions.configurations.canRestartTimer
Boolean
Can the exit timer be restarted?
deviceDetails.partitions.configurations.entryDelay
Integer
Number of seconds after entry before alarm is triggered
deviceDetails.partitions.configurations.exitDelay
Integer
Number of seconds after arming user has to exit
deviceDetails.partitions.configurations.setStateConfigs
Array
Array of possible arming modes
deviceDetails.partitions.configurations.setStateConfigs.setState
String
Setting state: "Disarm", "ArmAway", "ArmStay"
deviceDetails.partitions.configurations.setStateConfigs.enableAlarm
Boolean
Does this setting enable the alarm?
deviceDetails.partitions.configurations.setStateConfigs.enableCamera
Boolean
Does this setting enable the camera?
deviceDetails.partitions.configurations.setStateConfigs.chimeVolume
Integer
Level of chime volume when changing to this config
deviceDetails.partitions.configurations.state
Object
Arming state information
deviceDetails.partitions.configurations.state.setState
String
Current arming mode
deviceDetails.partitions.configurations.state.inEntryDelay
Boolean
Is device in entry delay?
deviceDetails.partitions.configurations.state.inExitDelay
Boolean
Is device in exit delay?
deviceDetails.partitions.configurations.state.alarmState
String
Current alarm state
deviceDetails.partitions.configurations.state.isTrouble
Boolean
Is there a tamper alert
deviceDetails.partitions.configurations.state.isBypassed
Boolean
Are sensors bypassed?
deviceDetails.partitions.configurations.state.lastUpdatedTime
DateTime
Last time the state was updated. In UTC.
deviceDetails.partitions.configurations.state.silentModeEnabled
Boolean
Is silent mode enabled?
deviceDetails.partitions.configurations.state.lastSetStateUpdatedTime
DateTime
Last set state change
deviceDetails.sensors
Array
Array of sensor information attached to base station
deviceDetails.sensors.id
String
ID of sensor
deviceDetails.sensors.name
String
Name of sensor (usually indicates location)
deviceDetails.sensors.configurations
Object
Sensor configuration information
deviceDetails.sensors.configurations.firmwareVersion
String
Sensor firmware version
deviceDetails.sensors.configurations.serialNumber
String
Sensor serial number
deviceDetails.sensors.configurations.bridgeId
String
Bridge ID
deviceDetails.sensors.configurations.sensitivity
Number
Sensitivity level
deviceDetails.sensors.configurations.chime
String
Chime configuration for sensor trigger
deviceDetails.sensors.configurations.isEnabled
Boolean
Is the sensor enabled?
deviceDetails.sensors.configurations.responseType
String
When will the sensor trigger an alert or chime
deviceDetails.sensors.configurations.sensorType
String
Sensor Type
deviceDetails.sensors.configurations.sensorSubType
String
Sensor Sub Type
deviceDetails.sensors.state
Object
Sensor state information
deviceDetails.sensors.state.isAlarm
Boolean
Is the sensor in alarm state
deviceDetails.sensors.state.isBypassed
Boolean
Is the sensor bypassed?
deviceDetails.sensors.state.isTrouble
Boolean
Has the sensor trouble alarm been tripped?
deviceDetails.sensors.state.isTampered
Boolean
Has the sensor tamper alarm been tripped?
deviceDetails.sensors.state.isEnrolled
Boolean
Is the sensor enrolled?
deviceDetails.sensors.state.isConnected
Boolean
Is the sensor connected?
deviceDetails.sensors.state.signalStrength
Integer
Current signal strength (if available)
deviceDetails.sensors.state.batteryState
Object
Battery state information
deviceDetails.keyFobs
Array
Data related to any KeyFobs connected
deviceDetails.keyFobs
Array
Data related to any KeyFobs connected
deviceDetails.keyFobs.id
String
ID of KeyFob
deviceDetails.keyFobs.name
String
Name of keyfob
deviceDetails.keyFobs.partitionId
String
Partition ID that KeyFob uses
deviceDetails.keyFobs.configurations
Object
KeyFob configuration information
deviceDetails.keyFobs.configurations.serialNumber
String
Serial number of KeyFob
deviceDetails.keyFobs.configurations.size
String
Size of KeyFob
deviceDetails.keyFobs.configurations.firmwareVersion
String
Firmware Version of KeyFob
deviceDetails.keyFobs.state
Object
State of KeyFob
deviceDetails.keyFobs.state.keyCommandMapping
Array
Array of objects pertaining to key command mapping
deviceDetails.keyFobs.state.isEnrolled
Boolean
Device is enrolled
deviceDetails.keyFobs.state.batteryState
Object
Battery state information
deviceDetails.keyFobs.state.batteryState.isLow
Boolean
Is the battery level low?
deviceDetails.keyFobs.state.batterystate.level
Float
Battery level (in percentage)
deviceDetails.automationDevices
Object
Automation devices information
deviceDetails.automationDevices.switches
Array
Information on switches connected to base station
deviceDetails.automationDevices.switches.configurations
Object
Switch configuration information
deviceDetails.automationDevices.switches.configurations.switchType
String
Switch type
deviceDetails.automationDevices.switches.configurations.switchSubType
String
Switch subtype
deviceDetails.automationDevices.switches.configurations.nodeId
String
Node ID
deviceDetails.automationDevices.switches.configurations.nodeDescription
String
Node description
deviceDetails.automationDevices.switches.configurations.automationDeviceType
String
Automation Device Type (e.g., "Output)
deviceDetails.automationDevices.switches.configurations.automationDeviceSubType
String
Device subtype (e.g., Switch Multilevel)
deviceDetails.automationDevices.switches.configurations.manufacturerName
String
deviceDetails.automationDevices.switches.configurations.manufacturerId
String
deviceDetails.automationDevices.switches.configurations.productId
String
deviceDetails.automationDevices.switches.configurations.productType
String
deviceDetails.automationDevices.switches.configurations.routerCapability
Boolean
deviceDetails.automationDevices.switches.configurations.associationState
Boolean
deviceDetails.automationDevices.switches.configurations.deviceSecurity
Boolean
deviceDetails.automationDevices.switches.configurations.specificType
Integer
deviceDetails.automationDevices.switches.configurations.securityMode
String
deviceDetails.automationDevices.switches.state
Object
State information
deviceDetails.automationDevices.switches.state.lastCommunicationStatusChangeTime
DateTime
Timestamp in UTC of last communication state change
deviceDetails.automationDevices.switches.state.value
Integer
deviceDetails.automationDevices.switches.state.isConnected
Boolean
Is the device connected?
deviceDetails.automationDevices.switches.state.inReplaceMode
Boolean
Is the device in replace mode?
deviceDetails.automationDevices.switches.id
String
Internal switch ID
deviceDetails.automationDevices.switches.name
String
User facing device name
deviceDetails.automationDevices.discoveredAutomationDevices
Array
Array of discovered automation devices
deviceDetails.automationDevices.discoveredAutomationDevices.id
String
Internal id of device
deviceDetails.automationDevices.discoveredAutomationDevices.nodeId
String
Node ID of device
deviceDetails.automationDevices.discoveredAutomationDevices.name
String
Name of device
deviceDetails.automationDevices.discoveredAutomationDevices.configurations
Object
Object of device configuration information
deviceDetails.automationDevices.discoveredAutomationDevices.configurations.commType
String
Communication type of device
deviceDetails.automationDevices.discoveredAutomationDevices.configurations.type
String
Device type
deviceDetails.automationDevices.discoveredAutomationDevices.state
Object
State information for device
deviceDetails.automationDevices.discoveredAutomationDevices.id
String
Internal id of device
deviceDetails.onboardDevices.deviceClass
String
Onboard device class
deviceDetails.onboardDevices.deviceType
String
Onboard device type
deviceDetails.onboardDevices.deviceID
String
Onboard device ID, used when calling livestream/status API
deviceDetails.onboardDevices.maxResolution
String
Device video resolution
deviceDetails.onboardDevices.manufacturer
String
Onboard device manufacturer
deviceDetails.onboardDevices.model
String
Device model
deviceDetails.onboardDevices.serial
String
Onboard device serial number
deviceDetails.onboardDevices.firmwareVer
String
Onboard device firmware version
deviceDetails.onboardDevices.macID
String
Onboard device MACID
deviceDetails.onboardDevices.userDefinedDeviceName
String
User defined device name
deviceDetails.onboardDevices.isAlive
Boolean
Is device online?
deviceDetails.onboardDevices.isUpgrading
Boolean
Is device updating?
deviceDetails.onboardDevices.isProvisioned
Boolean
Is device provisioning?
deviceDetails.onboardDevices.wifiStrength
String
Wifi signal strength
geoFence
Boolean
Is device using geofencing?
deviceClass
String
Class of base device
deviceType
String
Device Type
deviceID
String
Unique ID of device
userDefinedDeviceName
String
User device device name
name
String
Device name
isAlive
Boolean
Is device alive?
isProvisioned
Boolean
Is device provisioned?
macID
String
Unique device MACID
deviceSettings
Object
Device settings listing
Water Leak Detector
Method
Description
Method
Description
GET
Get temperature and humidity sensor history
https://api.honeywell.com/v2/devices/waterLeakDetectors/{deviceId}/history
This resource will return reading history for a particular deviceId. The readings returned are temperature and humidity, not leak detection.
Dates are in the following format: "mm/dd/yyyy"
Response Model ExampleData Definitions
[
{
"time": "2015-11-02T00:01:32",
"humidity": "32.2",
"temperature": "22.86"
},
{
"time": "2015-11-02T00:06:44",
"humidity": "32.2",
"temperature": "22.85"
},
{
"time": "2015-11-02T00:11:55",
"humidity": "32.2",
"temperature": "22.88"
},
{
"time": "2015-11-02T00:16:57",
"humidity": "32.2",
"temperature": "22.84"
},
{
"time": "2015-11-02T00:21:08",
"humidity": "32.2",
"temperature": "22.9"
}
]
Field Name/Location
Data Type
Definition
time
DateTime
Date and time the reading was captured
humidity
String
Humidity value returned as a string, interpret as a percentage
temperature
String
Temperature value returned as a string, always in Celcius units
Thermostat
Method
Description
, Water Leak Detector
Method
Description
, Camera
Method
Description
, Smart Home Security
Method
Description
, Shutoff Valve
Method
Description
Method
Description
Method
Description
Method
Description
Method
Description
Method
Description
GET
Get all Locations and Devices
https://api.honeywell.com/v2/locations
Get all locations, this will also return all devices within those locations
For specific device data structures, please see each specific device type's GET by ID command
Response Model ExampleData Definitions
[
{
"locationID": 559589,
"name": "Home",
"country": "US",
"zipcode": "55422",
"devices": [
{
"deviceDetails": {
"configurations": {
"model": "DAS",
"firmwareVersion": "HDAS_GL.1.2.006.0091",
"commApiVersion": "1.0.0.1",
"mac": "B82CA0032222",
"serialNumber": "0x956D1AC8\n",
"wifiInfo": {
"name": "HCH_A1"
},
"firmwareUpgradeInfo": {
"lastSuccessfulUpgradeTime": "2018-10-03T12:29:26.3828809Z",
"lastUpgradeStartTime": "2018-10-03T12:25:15.3624593Z",
"expectedUpgradeCompletionTime": "2018-10-03T12:33:15.3624593Z"
},
"primaryZWaveController": {
"id": "1",
"name": "SUC/SIS Controller",
"configurations": {
"version": "C07,0500 (4.61)",
"homeId": "c533d2be",
"type": "SucSis",
"nodeId": "1",
"nodeDescription": "SUC/SIS Controller",
"automationDeviceType": "Output",
"automationDeviceSubType": "Controller",
"manufacturerName": "Honeywell ",
"manufacturerId": "Controller",
"productId": "1",
"productType": "8",
"routerCapability": false,
"associationState": false,
"deviceSecurity": true,
"specificType": 10,
"securityMode": "Wep"
},
"state": {
"value": 0,
"isConnected": true,
"inReplaceMode": false
}
},
"voiceCommands": [
{
"voiceEngine": "Alexa",
"enabled": true
}
]
},
"state": {
"isACLoss": false,
"batteryState": {
"isLow": false,
"level": 100
},
"isTampered": false,
"isOnline": true,
"discoveryMode": "Disable",
"lastCommunicationStatusChange": "2019-04-03T20:15:55.3498069Z",
"isSyncInProgress": false,
"isUpgradeInProgress": false,
"alexaConnectionState": "Disconnect",
"isMandatoryFirmwareUpgradeRequired": false
},
"partitions": [
{
"id": "1",
"name": "Lyric Home",
"configurations": {
"canRestartTimer": false,
"entryDelay": 15,
"exitDelay": 15,
"enableDeterrence": false,
"setStateConfigs": [
{
"setState": "Disarm",
"enableAlarm": false,
"enableCamera": false,
"chimeVolume": 22,
"enableDeterrence": false,
"enableOsmv": false
},
{
"setState": "ArmAway",
"enableAlarm": true,
"enableCamera": true,
"chimeVolume": 22,
"enableDeterrence": false,
"enableOsmv": true
},
{
"setState": "ArmStay",
"enableAlarm": true,
"enableCamera": false,
"chimeVolume": 22,
"enableDeterrence": false,
"enableOsmv": true
}
],
"deterrenceActions": {
"chimes": [
"DogBark"
]
}
},
"state": {
"setState": "Disarm",
"inEntryDelay": false,
"inExitDelay": false,
"alarmState": "None",
"isTrouble": false,
"isFault": true,
"isBypassed": false,
"lastUpdatedTime": "2019-04-17T17:40:26.8661883Z",
"silentModeEnabled": true,
"lastSetStateUpdatedTime": "2019-04-17T17:40:26.8661883Z"
}
}
],
"sensors": [
{
"id": "3",
"name": "Living Room Window",
"configurations": {
"firmwareVersion": "06155A35",
"serialNumber": "306184470:1",
"bridgeId": "3",
"sensitivity": 0,
"chime": "Standard",
"isEnabled": true,
"sensorCommType": "Unknown",
"responseType": "Perimeter",
"sensorType": "Input",
"sensorSubType": "Contact"
},
"state": {
"isAlarm": false,
"isBypassed": false,
"isFault": true,
"isTrouble": false,
"isTampered": false,
"supervisionFailed": false,
"isEnrolled": true,
"isConnected": true,
"signalStrength": 0,
"batteryState": {
"isLow": false,
"level": 0
},
"activeTests": [],
"isVerified": false
}
},
{
"id": "2",
"name": "Front Door",
"configurations": {
"firmwareVersion": "06155A35",
"serialNumber": "306184545:1",
"bridgeId": "2",
"sensitivity": 0,
"chime": "Standard",
"isEnabled": true,
"sensorCommType": "Unknown",
"responseType": "EntryExit",
"sensorType": "Input",
"sensorSubType": "Contact"
},
"state": {
"isAlarm": false,
"isBypassed": false,
"isFault": true,
"isTrouble": false,
"isTampered": false,
"supervisionFailed": false,
"isEnrolled": true,
"isConnected": true,
"signalStrength": 0,
"batteryState": {
"isLow": false,
"level": 0
},
"activeTests": [],
"isVerified": false
}
},
{
"id": "4",
"name": "Front Porch",
"configurations": {
"firmwareVersion": "09215B13",
"serialNumber": "1128923551:1",
"bridgeId": "4",
"sensitivity": 0,
"chime": "Standard",
"isEnabled": true,
"sensorCommType": "Unknown",
"responseType": "NoResponse",
"sensorType": "Pir",
"sensorSubType": "Osmv"
},
"state": {
"isAlarm": false,
"isBypassed": false,
"isFault": false,
"isTrouble": false,
"isTampered": false,
"supervisionFailed": false,
"isEnrolled": true,
"isConnected": true,
"signalStrength": 0,
"batteryState": {
"isLow": false,
"level": 0
},
"activeTests": [],
"isVerified": false
}
}
],
"keyFobs": [
{
"id": "131",
"name": "Fob1",
"partitionId": "1",
"configurations": {
"serialNumber": "306708788:0",
"size": 0,
"firmwareVersion": "07155A4B"
},
"state": {
"keyCommandMapping": [
{
"keyIndex": 131,
"commandIndex": 21
},
{
"keyIndex": 132,
"commandIndex": 22
},
{
"keyIndex": 133,
"commandIndex": 20
},
{
"keyIndex": 134,
"commandIndex": 7
}
],
"isEnrolled": true,
"batteryState": {
"isLow": false,
"level": 60
},
"signalStrength": 0
}
}
],
"automationDevices": {
"switches": [
{
"configurations": {
"switchType": "Dimmer",
"switchSubType": "Default",
"nodeId": "2",
"nodeDescription": "Switch 001",
"automationDeviceType": "Output",
"automationDeviceSubType": "Switch Multilevel",
"manufacturerName": "Honeywell Multi Mode Comm., 5044, 3033",
"manufacturerId": "Switch Multilevel",
"productId": "3033",
"productType": "5044",
"routerCapability": false,
"associationState": false,
"deviceSecurity": false,
"specificType": 2,
"securityMode": "Open"
},
"state": {
"lastCommunicationStatusChangeTime": "2019-02-26T22:17:03.9144634Z",
"value": 0,
"isConnected": false,
"inReplaceMode": false
},
"id": "AD_1",
"name": "Outlet"
},
{
"configurations": {
"switchType": "Toggle",
"switchSubType": "Default",
"nodeId": "3",
"nodeDescription": "Switch 002",
"automationDeviceType": "Output",
"automationDeviceSubType": "Switch Binary",
"manufacturerName": "Jasco Products Multi Mode Comm., 5052, 3039",
"manufacturerId": "Switch Binary",
"productId": "3039",
"productType": "5052",
"routerCapability": false,
"associationState": false,
"deviceSecurity": false,
"specificType": 1,
"securityMode": "Open"
},
"state": {
"lastCommunicationStatusChangeTime": "2019-03-06T20:08:16.0600441Z",
"value": 1,
"isConnected": false,
"inReplaceMode": false
},
"id": "AD_2",
"name": "Printer"
},
{
"configurations": {
"switchType": "Dimmer",
"switchSubType": "Default",
"nodeId": "4",
"nodeDescription": "Switch 003",
"automationDeviceType": "Output",
"automationDeviceSubType": "Switch Multilevel",
"manufacturerName": "Jasco Products Multi Mode Comm., 4C42, 3031",
"manufacturerId": "Switch Multilevel",
"productId": "3031",
"productType": "4c42",
"routerCapability": false,
"associationState": false,
"deviceSecurity": false,
"specificType": 2,
"securityMode": "Open"
},
"state": {
"lastCommunicationStatusChangeTime": "2019-04-01T19:59:15.518994Z",
"value": 99,
"isConnected": true,
"inReplaceMode": false
},
"id": "AD_3",
"name": "Lamp"
}
]
},
"onboardDevices": [
{
"deviceClass": "Camera",
"deviceType": "BuiltIn",
"deviceID": "21034",
"maxResolution": "1920x1080",
"manufacturer": "Honeywell Technology Solutions Pvt Ltd",
"model": "HONDASCP100",
"serial": "111122223333",
"firmwareVer": "90",
"macID": "B8:2C:A0:03:22:22",
"userDefinedDeviceName": "Living Room",
"isAlive": true,
"isUpgrading": false,
"isProvisioned": true,
"wifiStrength": "",
"backend": "EMX",
"peopleDetectionState": "None"
}
]
},
"geoFence": "off",
"frConfiguration": {
"maxPersons": 2,
"plan": "Free"
},
"deviceClass": "DeviceGateway",
"deviceType": "HONDAS",
"deviceID": "LSC-B82CA0032222",
"userDefinedDeviceName": "Security",
"name": "Security",
"isAlive": true,
"isProvisioned": true,
"macID": "B82CA0032222",
"deviceSettings": {},
"service": {
"mode": "Up"
}
},
{
"firmwareVersion": "1.1.0.0",
"displayedOutdoorHumidity": 39,
"vacationHold": {
"vacationStart": "2019-04-25T19:05:48",
"vacationEnd": "2019-04-26T19:05:48",
"heatSetpoint": 70,
"coolSetpoint": 72,
"enabled": true
},
"currentSchedulePeriod": {
"day": "Monday",
"period": "Away"
},
"scheduleCapabilities": {
"availableScheduleTypes": [
"None",
"Geofenced",
"TimedNorthAmerica"
],
"schedulableFan": false
},
"scheduleType": {
"scheduleType": "Timed",
"scheduleSubType": "NA"
},
"scheduleStatus": "Resume",
"allowedTimeIncrements": 15,
"settings": {
"hardwareSettings": {
"brightness": 2,
"maxBrightness": 10
},
"fan": {
"allowedModes": [
"On",
"Auto"
],
"changeableValues": {
"mode": "Auto"
},
"allowedSpeeds": [
{
"item": "Low",
"value": {
"speed": 1,
"mode": "On"
}
},
{
"item": "Medium",
"value": {
"speed": 2,
"mode": "On"
}
},
{
"item": "High",
"value": {
"speed": 3,
"mode": "On"
}
},
{
"item": "Auto",
"value": {
"speed": null,
"mode": "Auto"
}
}
]
},
"temperatureMode": {
"air": true
},
"specialMode": {}
},
"deviceClass": "Thermostat",
"deviceType": "Thermostat",
"deviceID": "LCC-B82CA00245E5",
"userDefinedDeviceName": "D6",
"name": "D6",
"isAlive": true,
"isUpgrading": false,
"isProvisioned": true,
"macID": "B82CA00245E5",
"deviceSettings": {},
"parentDeviceId": 1,
"partnerInfo": {
"singleOrMultiODUConfiguration": 1,
"parentDeviceModelId": 1,
"parentDeviceBrandId": 1,
"oduName": "Outdoor Unit 1"
},
"service": {
"mode": "Up"
},
"deviceRegistrationDate": "2018-05-30T19:57:05.2866667",
"units": "Fahrenheit",
"indoorTemperature": 76,
"outdoorTemperature": 68.7,
"allowedModes": [
"Heat",
"Off",
"Cool"
],
"deadband": 0,
"hasDualSetpointStatus": false,
"minHeatSetpoint": 61,
"maxHeatSetpoint": 88,
"minCoolSetpoint": 61,
"maxCoolSetpoint": 88,
"changeableValues": {
"mode": "Off",
"heatSetpoint": 62,
"coolSetpoint": 85,
"thermostatSetpointStatus": "NoHold",
"nextPeriodTime": "18:00:00",
"endHeatSetpoint": 62,
"endCoolSetpoint": 85,
"heatCoolMode": "Heat"
},
"operationStatus": {
"mode": "EquipmentOff",
"fanRequest": false,
"circulationFanRequest": false
},
"indoorHumidity": 32,
"indoorHumidityStatus": "Measured",
"deviceModel": "D6"
},
{
"waterPresent": false,
"currentSensorReadings": {
"time": "2019-04-24T13:59:02",
"temperature": 21.55,
"humidity": 30.5
},
"currentAlarms": [],
"lastCheckin": "2019-04-24T13:59:03",
"lastDeviceSettingUpdatedOn": "0001-01-01T00:00:00",
"batteryRemaining": 50,
"isRegistered": true,
"hasDeviceCheckedIn": true,
"isDeviceOffline": false,
"firstFailedAttemptTime": "0001-01-01T00:00:00",
"failedConnectionAttempts": 0,
"wifiSignalStrength": -29,
"time": "2019-04-24T13:59:02",
"deviceClass": "LeakDetector",
"deviceType": "Water Leak Detector",
"deviceID": "a15b7da4-3d19-4869-a48e-3cb4cf7f9fc7",
"userDefinedDeviceName": "Basement",
"backend": {},
"isAlive": true,
"isUpgrading": false,
"isProvisioned": true,
"deviceSettings": {
"temp": {
"high": {
"limit": 26.5
},
"low": {
"limit": 15.5
}
},
"humidity": {
"high": {
"limit": 85
},
"low": {
"limit": 20
}
},
"userDefinedName": "Basement",
"buzzerMuted": false,
"checkinPeriod": 8,
"currentSensorReadPeriod": 60
},
"service": {
"mode": "Up"
},
"deviceRegistrationDate": "2018-06-19T19:02:40.73"
},
{
"firmwareVersion": "1.0.6.0",
"displayedOutdoorHumidity": 39,
"vacationHold": {
"vacationStart": "2019-04-25T08:05:36",
"vacationEnd": "2019-04-26T08:05:36",
"heatSetpoint": 70,
"coolSetpoint": 72,
"enabled": true
},
"currentSchedulePeriod": {
"day": "Monday",
"period": "Away"
},
"scheduleCapabilities": {
"availableScheduleTypes": [
"None",
"Geofenced",
"TimedNorthAmerica"
],
"schedulableFan": false
},
"scheduleType": {
"scheduleType": "Timed",
"scheduleSubType": "NA"
},
"scheduleStatus": "Resume",
"allowedTimeIncrements": 15,
"settings": {
"hardwareSettings": {
"brightness": 10,
"maxBrightness": 10
},
"fan": {
"allowedModes": [
"On",
"Auto"
],
"changeableValues": {
"mode": "Auto"
},
"allowedSpeeds": [
{
"item": "Low",
"value": {
"speed": 1,
"mode": "On"
}
},
{
"item": "Medium",
"value": {
"speed": 2,
"mode": "On"
}
},
{
"item": "High",
"value": {
"speed": 3,
"mode": "On"
}
},
{
"item": "Auto",
"value": {
"speed": null,
"mode": "Auto"
}
}
]
},
"temperatureMode": {
"air": true
},
"specialMode": {}
},
"deviceClass": "Thermostat",
"deviceType": "Thermostat",
"deviceID": "LCC-B82CA00BD3D9",
"userDefinedDeviceName": "D62",
"name": "D62",
"isAlive": true,
"isUpgrading": false,
"isProvisioned": true,
"macID": "B82CA00BD3D9",
"deviceSettings": {},
"parentDeviceId": 1,
"partnerInfo": {
"singleOrMultiODUConfiguration": 1,
"parentDeviceModelId": 1,
"parentDeviceBrandId": 1
},
"service": {
"mode": "Up"
},
"deviceRegistrationDate": "2019-02-19T20:32:39.4166667",
"units": "Fahrenheit",
"indoorTemperature": 74,
"outdoorTemperature": 68.7,
"allowedModes": [
"Heat",
"Off",
"Cool"
],
"deadband": 0,
"hasDualSetpointStatus": false,
"minHeatSetpoint": 61,
"maxHeatSetpoint": 88,
"minCoolSetpoint": 61,
"maxCoolSetpoint": 88,
"changeableValues": {
"mode": "Off",
"heatSetpoint": 62,
"coolSetpoint": 85,
"thermostatSetpointStatus": "NoHold",
"nextPeriodTime": "18:00:00",
"endHeatSetpoint": 62,
"endCoolSetpoint": 85,
"heatCoolMode": "Heat"
},
"operationStatus": {
"mode": "EquipmentOff",
"fanRequest": false,
"circulationFanRequest": false
},
"indoorHumidity": 32,
"indoorHumidityStatus": "Measured",
"deviceModel": "D6"
},
{
"groups": [
{
"id": 0,
"name": "default",
"rooms": [
0,
1,
2,
3
]
}
],
"displayedOutdoorHumidity": 51,
"vacationHold": {
"enabled": false
},
"currentSchedulePeriod": {
"day": "Wednesday",
"period": "Away"
},
"scheduleCapabilities": {
"availableScheduleTypes": [
"None",
"Geofenced",
"TimedNorthAmerica"
],
"schedulableFan": true
},
"scheduleType": {
"scheduleType": "Timed",
"scheduleSubType": "NA"
},
"scheduleStatus": "Resume",
"allowedTimeIncrements": 15,
"settings": {
"hardwareSettings": {
"brightness": 0,
"maxBrightness": 0
},
"fan": {
"allowedModes": [
"On",
"Auto",
"Circulate"
],
"changeableValues": {
"mode": "Auto"
}
},
"temperatureMode": {
"air": true
},
"specialMode": {
"autoChangeoverActive": false
}
},
"deviceClass": "Thermostat",
"deviceType": "Thermostat",
"deviceID": "LCC-B82CA0196B73",
"userDefinedDeviceName": "Living Room",
"name": "Living Room",
"isAlive": false,
"isUpgrading": false,
"isProvisioned": true,
"macID": "B82CA0196B73",
"deviceSettings": {},
"priorityType": "PickARoom",
"service": {
"mode": "Up"
},
"deviceRegistrationDate": "2019-03-21T20:14:34.6833333",
"units": "Fahrenheit",
"indoorTemperature": 73,
"outdoorTemperature": 45.5,
"allowedModes": [
"Heat",
"Off",
"Cool",
"Auto"
],
"deadband": 0,
"hasDualSetpointStatus": false,
"minHeatSetpoint": 50,
"maxHeatSetpoint": 90,
"minCoolSetpoint": 50,
"maxCoolSetpoint": 90,
"changeableValues": {
"mode": "Heat",
"autoChangeoverActive": false,
"heatSetpoint": 62,
"coolSetpoint": 85,
"thermostatSetpointStatus": "NoHold",
"nextPeriodTime": "18:00:00",
"heatCoolMode": "Heat"
},
"operationStatus": {
"mode": "EquipmentOff",
"fanRequest": false,
"circulationFanRequest": false
},
"indoorHumidity": 21,
"indoorHumidityStatus": "Measured",
"deviceModel": "T9-T10"
},
{
"displayedOutdoorHumidity": 39,
"vacationHold": {
"enabled": false
},
"currentSchedulePeriod": {
"day": "Monday",
"period": "Away"
},
"scheduleCapabilities": {
"availableScheduleTypes": [
"None",
"Geofenced",
"TimedNorthAmerica"
],
"schedulableFan": false
},
"scheduleType": {
"scheduleType": "Timed",
"scheduleSubType": "NA"
},
"scheduleStatus": "Pause",
"allowedTimeIncrements": 15,
"settings": {
"hardwareSettings": {
"brightness": 0,
"maxBrightness": 5
},
"fan": {
"allowedModes": [
"On",
"Auto",
"Circulate"
],
"changeableValues": {
"mode": "On"
}
},
"temperatureMode": {
"air": true
},
"specialMode": {
"autoChangeoverActive": false
}
},
"deviceClass": "Thermostat",
"deviceType": "Thermostat",
"deviceID": "LCC-00D02DBBB86A",
"userDefinedDeviceName": "T61",
"name": "T61",
"isAlive": true,
"isUpgrading": false,
"isProvisioned": true,
"macID": "00D02DBBB86A",
"deviceSettings": {},
"service": {
"mode": "Up"
},
"deviceRegistrationDate": "2019-03-22T16:37:31.24",
"units": "Fahrenheit",
"indoorTemperature": 76,
"outdoorTemperature": 68.7,
"allowedModes": [
"Heat",
"Off",
"Cool",
"Auto"
],
"deadband": 0,
"hasDualSetpointStatus": false,
"minHeatSetpoint": 50,
"maxHeatSetpoint": 90,
"minCoolSetpoint": 50,
"maxCoolSetpoint": 90,
"changeableValues": {
"mode": "Heat",
"autoChangeoverActive": false,
"heatSetpoint": 62,
"coolSetpoint": 85,
"thermostatSetpointStatus": "PermanentHold",
"heatCoolMode": "Heat"
},
"operationStatus": {
"mode": "EquipmentOff",
"fanRequest": false,
"circulationFanRequest": false
},
"deviceModel": "T5-T6"
},
{
"displayedOutdoorHumidity": 39,
"vacationHold": {
"enabled": false
},
"currentSchedulePeriod": {
"day": "Monday",
"period": "Home"
},
"scheduleCapabilities": {
"availableScheduleTypes": [
"None",
"Geofenced",
"TimedNorthAmerica"
],
"schedulableFan": false
},
"scheduleType": {
"scheduleType": "None"
},
"scheduleStatus": "Pause",
"allowedTimeIncrements": 15,
"settings": {
"hardwareSettings": {
"brightness": 5,
"maxBrightness": 5
},
"fan": {
"allowedModes": [
"On",
"Auto",
"Circulate"
],
"changeableValues": {
"mode": "On"
}
},
"temperatureMode": {
"air": false
},
"specialMode": {
"autoChangeoverActive": false
}
},
"deviceClass": "Thermostat",
"deviceType": "Thermostat",
"deviceID": "LCC-00D02DAC6E81",
"userDefinedDeviceName": "T5",
"name": "T5",
"isAlive": true,
"isUpgrading": false,
"isProvisioned": true,
"macID": "00D02DAC6E81",
"deviceSettings": {},
"service": {
"mode": "Up"
},
"deviceRegistrationDate": "2019-03-22T16:45:40.9933333",
"units": "Fahrenheit",
"indoorTemperature": 76,
"outdoorTemperature": 68.7,
"allowedModes": [
"Heat",
"Off",
"Cool",
"Auto"
],
"deadband": 0,
"hasDualSetpointStatus": false,
"minHeatSetpoint": 50,
"maxHeatSetpoint": 90,
"minCoolSetpoint": 50,
"maxCoolSetpoint": 90,
"changeableValues": {
"mode": "Heat",
"autoChangeoverActive": false,
"heatSetpoint": 68,
"coolSetpoint": 85,
"thermostatSetpointStatus": "NoHold",
"heatCoolMode": "Heat"
},
"operationStatus": {
"mode": "EquipmentOff",
"fanRequest": false,
"circulationFanRequest": false
},
"deviceModel": "T5-T6"
},
{
"displayedOutdoorHumidity": 94,
"vacationHold": {
"enabled": false
},
"currentSchedulePeriod": {
"day": "Monday",
"period": "Away"
},
"scheduleCapabilities": {
"availableScheduleTypes": [
"None",
"Geofenced",
"TimedNorthAmerica"
],
"schedulableFan": false
},
"scheduleType": {
"scheduleType": "Timed",
"scheduleSubType": "NA"
},
"scheduleStatus": "Pause",
"allowedTimeIncrements": 15,
"settings": {
"hardwareSettings": {
"brightness": 0,
"maxBrightness": 5
},
"ventilationModeSettings": {
"changeableValues": "Auto",
"ventilationTimer": 0,
"ventilationCoreTimer": 0,
"ventilationSpeed": 0,
"ventilationFanRequested": false
},
"fan": {
"allowedModes": [
"On",
"Auto",
"Circulate"
],
"changeableValues": {
"mode": "Auto"
}
},
"temperatureMode": {
"air": true
},
"specialMode": {}
},
"deviceClass": "Thermostat",
"deviceType": "Thermostat",
"deviceID": "LCC-00D02DAB5C8E",
"userDefinedDeviceName": "Pro",
"name": "Pro",
"isAlive": false,
"isUpgrading": false,
"isProvisioned": true,
"macID": "00D02DAB5C8E",
"deviceSettings": {},
"service": {
"mode": "Up"
},
"deviceRegistrationDate": "2019-03-22T16:59:54.3933333",
"units": "Fahrenheit",
"indoorTemperature": 73,
"outdoorTemperature": 45,
"allowedModes": [
"Heat",
"Off",
"Cool"
],
"deadband": 0,
"hasDualSetpointStatus": false,
"minHeatSetpoint": 50,
"maxHeatSetpoint": 90,
"minCoolSetpoint": 50,
"maxCoolSetpoint": 90,
"changeableValues": {
"mode": "Cool",
"heatSetpoint": 72,
"coolSetpoint": 75,
"thermostatSetpointStatus": "PermanentHold",
"heatCoolMode": "Cool"
},
"operationStatus": {
"mode": "EquipmentOff",
"fanRequest": false,
"circulationFanRequest": false
},
"deviceModel": "T5-T6"
},
{
"thermostatVersion": "02.02.20.00",
"scheduleStatus": "Resume",
"allowedTimeIncrements": 15,
"settings": {
"homeSetPoints": {
"homeHeatSP": 70,
"homeCoolSP": 78,
"units": "Fahrenheit"
},
"awaySetPoints": {
"awayHeatSP": 62,
"awayCoolSP": 85,
"smartCoolSP": 80,
"smartHeatSP": 55,
"useAutoSmart": true,
"units": "Fahrenheit"
},
"hardwareSettings": {
"brightness": 6,
"volume": 10,
"maxBrightness": 10,
"maxVolume": 10
},
"fan": {
"allowedModes": [
"Auto",
"On",
"Circulate"
],
"changeableValues": {
"mode": "Circulate"
},
"fanRunning": false
},
"temperatureMode": {
"feelsLike": false,
"air": false
},
"specialMode": {
"autoChangeoverActive": false,
"emergencyHeatActive": true
}
},
"deviceClass": "Thermostat",
"deviceType": "Thermostat",
"deviceID": "TCC-1882318",
"userDefinedDeviceName": "Round",
"name": "Round",
"schedule": {
"scheduleType": "Geofence"
},
"isAlive": false,
"isUpgrading": false,
"isProvisioned": false,
"macID": "00D02D7F0959",
"deviceSettings": {},
"service": {
"mode": "Up"
},
"deviceRegistrationDate": "2019-03-25T16:55:37.76",
"units": "Fahrenheit",
"indoorTemperature": 73,
"outdoorTemperature": 58,
"allowedModes": [
"Cool",
"Heat",
"Off",
"Auto"
],
"deadband": 0,
"hasDualSetpointStatus": false,
"minHeatSetpoint": 40,
"maxHeatSetpoint": 99,
"minCoolSetpoint": 40,
"maxCoolSetpoint": 99,
"changeableValues": {
"mode": "Heat",
"autoChangeoverActive": false,
"emergencyHeatActive": true,
"heatSetpoint": 70,
"coolSetpoint": 78,
"heatCoolMode": "Heat"
},
"operationStatus": {
"mode": "EquipmentOff"
},
"smartAway": {
"active": false,
"timeOfDay": "00:00:00",
"durationInHours": 0,
"durationInDays": 0,
"lastUsedFormat": "TimeOfDay",
"endsIn": "2000-01-01T00:00:00-06:00"
},
"indoorHumidity": 32,
"indoorHumidityStatus": "Measured",
"deviceModel": "Round"
}
],
"users": [
{
"userID": 625115,
"username": "hwhome.test.1@gmail.com",
"firstname": "hw",
"lastname": "test",
"created": 1516641186,
"deleted": -62135596800,
"activated": true,
"connectedHomeAccountExists": true,
"locationRoleMapping": [
{
"locationID": 559589,
"role": "Adult",
"locationName": "Home",
"status": 1
}
],
"isOptOut": "",
"isCurrentUser": true
},
{
"userID": 81447,
"username": "hw.alexa.1@gmail.com",
"firstname": "Hw",
"lastname": "Alexa",
"created": 1466524834,
"deleted": -62135596800,
"activated": true,
"connectedHomeAccountExists": true,
"locationRoleMapping": [
{
"locationID": 559589,
"role": "Adult",
"locationName": "hw_Home",
"status": 1
}
],
"isOptOut": "",
"isCurrentUser": false
},
{
"userID": 87020,
"username": "developerinfo@resideo.com",
"firstname": "resideo",
"lastname": "ApiSupport",
"created": 1469546366,
"deleted": -62135596800,
"activated": true,
"connectedHomeAccountExists": true,
"locationRoleMapping": [
{
"locationID": 559589,
"role": "Adult",
"locationName": "hw_Home",
"status": 1
}
],
"isOptOut": "",
"isCurrentUser": false
}
],
"timeZoneId": "Central",
"timeZone": "Central Standard Time",
"ianaTimeZone": "America/Chicago",
"daylightSavingTimeEnabled": true,
"geoFences": [
{
"geofenceEnabled": true,
"geoFenceID": 566868,
"latitude": 45.0006638,
"longitude": -93.36234,
"radius": 500,
"geoOccupancy": {
"withinFence": 0,
"outsideFence": 1
}
}
],
"geoFenceEnabled": true,
"predictiveAIREnabled": false,
"comfortLevel": 0,
"geoFenceNotificationEnabled": true,
"geoFenceNotificationTypeId": 13,
"configuration": {
"faceRecognition": {
"enabled": true,
"maxPersons": 2,
"maxEtas": 2,
"maxEtaPersons": 1,
"schedules": [
{
"time": [
{
"start": "15:00:00",
"end": "17:00:00"
}
],
"days": [
"Sunday",
"Monday",
"Tuesday",
"Wednesday",
"Thursday",
"Friday",
"Saturday"
]
}
]
}
}
},
{
"locationID": 559598,
"name": "UK",
"country": "GB",
"zipcode": "KT12 5PY",
"devices": [
{
"displayedOutdoorHumidity": 87,
"vacationHold": {
"enabled": false
},
"currentSchedulePeriod": {
"day": "Wednesday",
"period": "P4"
},
"scheduleCapabilities": {
"availableScheduleTypes": [
"None",
"Geofenced",
"TimedEmea"
],
"schedulableFan": false
},
"scheduleType": {
"scheduleType": "Timed",
"scheduleSubType": "EMEA"
},
"dhwZone": {
"deviceId": "LCC-DHW-00D02DE7ED4E",
"deviceClass": "DHW",
"deviceType": "DHW",
"dhw": {
"dhwState": "Off",
"status": "NoHold",
"boostDuration": 0,
"vacationHold": {
"enabled": true
},
"geoBoostEnabled": false,
"nextPeriodTime": "00:00:00"
},
"currentSchedulePeriod": {
"day": "Wednesday",
"period": "P6"
}
},
"scheduleStatus": "Resume",
"allowedTimeIncrements": 10,
"settings": {
"hardwareSettings": {
"brightness": 4,
"maxBrightness": 5
},
"temperatureMode": {
"air": false
},
"specialMode": {}
},
"deviceClass": "Thermostat",
"deviceType": "Thermostat",
"deviceID": "LCC-00D02DE7ED4E",
"userDefinedDeviceName": "DHW",
"name": "DHW",
"isAlive": false,
"isUpgrading": false,
"isProvisioned": true,
"macID": "00D02DE7ED4E",
"deviceSettings": {},
"service": {
"mode": "Up"
},
"deviceRegistrationDate": "2018-11-13T20:02:10.88",
"units": "Celsius",
"indoorTemperature": 23,
"outdoorTemperature": 4,
"allowedModes": [
"Heat",
"Off"
],
"deadband": 0,
"hasDualSetpointStatus": false,
"minHeatSetpoint": 5,
"maxHeatSetpoint": 35,
"minCoolSetpoint": -18,
"maxCoolSetpoint": -18,
"changeableValues": {
"mode": "Heat",
"heatSetpoint": 16,
"coolSetpoint": 10,
"thermostatSetpointStatus": "NoHold",
"heatCoolMode": "Heat",
"endHeatSetpoint": null,
"endCoolSetpoint": null
},
"operationStatus": {
"mode": "EquipmentOff",
"fanRequest": false,
"circulationFanRequest": false
},
"deviceModel": "T5-T6"
},
{
"deviceClass": "ShutoffValve",
"deviceType": "L5 Leak Protection Valve",
"deviceID": "4579041",
"deviceInternalID": 4579041,
"userDefinedDeviceName": "Basement",
"isAlive": true,
"isProvisioned": true,
"deviceRegistrationDate": "2022-10-19T16:39:37.997",
"titanDeviceType": "homes.d.l5leakprotectionvalve",
"deviceMac": "48A2E691D4DA",
"dataSyncInfo": {
"state": "Completed",
"transactionId": "qPQBUIxArASeqs3Z"
},
"lastCheckin": "2022-12-13T21:25:52.944+00:00",
"actuatorValve": {
"commandSource": "app",
"runningTime": 7653,
"valveStatus": "Open",
"motorCycles": 15,
"motorCurrentAverage": 92,
"motorCurrentMax": 0,
"deviceTemperature": 86.6,
"lastAntiScaleTime": "2022-12-01T07:00:00.000+00:00",
"leakStatus": "Na",
"timeValveChanged": "2022-12-13T20:17:53.605+00:00"
},
"daylightSavingsInfo": {
"isDaylightSaving": false,
"nextOffsetChange": "2023-03-12T08:00:00.000+00:00"
},
"maintenance": {
"antiScaleSettings": "OncePerMonth",
"antiScaleDOWSettings": "Sunday",
"antiScaleDOMSettings": 1,
"antiScaleTimeSettings": "07:00"
}
}
],
"users": [
{
"userID": 625115,
"username": "hwhome.test.1@gmail.com",
"firstname": "hw",
"lastname": "test",
"created": 1516641186,
"deleted": -62135596800,
"activated": true,
"connectedHomeAccountExists": true,
"locationRoleMapping": [
{
"locationID": 559598,
"role": "Adult",
"locationName": "UK",
"status": 1
}
],
"isOptOut": "",
"isCurrentUser": true
}
],
"timeZone": "GMT Standard Time",
"ianaTimeZone": "Europe/London",
"daylightSavingTimeEnabled": true,
"geoFenceEnabled": false,
"predictiveAIREnabled": false,
"comfortLevel": 0,
"geoFenceNotificationEnabled": false,
"geoFenceNotificationTypeId": 13,
"configuration": {
"faceRecognition": {
"enabled": false,
"maxPersons": 2,
"maxEtas": 2,
"maxEtaPersons": 1,
"schedules": [
{
"time": [
{
"start": "15:00:00",
"end": "17:00:00"
}
],
"days": [
"Sunday",
"Monday",
"Tuesday",
"Wednesday",
"Thursday",
"Friday",
"Saturday"
]
}
]
}
}
}
]
Field Name/Location
Data Type
Definition
locationID
Integer
Unique LocationID for a user's location.
name
String
User-defined name of location
streetAddress
String
User-defined street address of location
city
String
User-defined city of location
state
String
User-defined US State
country
String
Country of location
zipcode
Integer
User-defined Zip Code of location
devices
Object Array
Array of objects containing device data for each device attached to the location
users
Object Array
Array of objects, each object contains data for each user with access to the location
user.userID
Integer
Unique UserID
user.username
String
User's username to login, usually an email address
user.firstname
String
User's first name
user.lastname
String
User's last name
user.created
Unix Timestamp
Date and time account was created in epoch format
user.deleted
Unix Timestamp
Date and time account was deleted, negative number if not deleted
user.activated
Boolean
True/false if user has been activated
user.connectedHomeAccountExists
Boolean
user.locationRoleMapping
Object Array
user.locationRoleMapping.locationID
Integer
user.locationRoleMapping.role
String
User role
user.locationRoleMapping.locationName
String
Name of location
user.locationRoleMapping.status
Integer
user.isCurrentUser
Boolean
Is this user the currently logged in user (determined from OAuth Token)
timeZone
String
Time Zone of the location
timeZoneId
String
ID of the TimeZone
daylightSavingTimeEnabled
Boolean
Is DST enabled for this location
geoFences
Array
Shows configuration of user-defined geofences from our application
geoFenceEnabled
Boolean
Is geofencing used by the user?