Properties API Reference
API endpoints for managing properties.
Get Properties
https://api.igloohome.co/home/propertiesReturns list of properties on the account
Query Parameters
limitnumber<int32>
Number of objects to return, from 1 to 300. Defaults to 100.- Constraints:
>= 1,<= 300 - Default:
100 - Example:
30
- Constraints:
cursorstring
The pagination cursor.cursoris a string ID that marks your place in the list. For instance, if you make a list request and receive 100 objects, withnextCursorof2sThyA1jii6WmTo3j, your next call can includecursor=2sThyA1jii6WmTo3jin order to fetch the next page of the list.sortstring
Order in which to return objects. Defaults todesc.- Default:
desc - Allowed values:
asc,desc
- Default:
Request Example
Responses
OK
Bad Request
Unauthorized, invalid or expired authorization token
Response
Forbidden. accessToken scope must contain 'igloohomeapi/get-properties'
Internal Server Error
Response body
nextCursorstring
A string pointing to the next page of results. Empty string indicates you reached the end of the list- Example:
2sFZqWxJuynYnwLHg
- Example:
payloadarray of object
An array containing the return propertiesnamestring
Name of the property- Example:
Singapore HQ
- Example:
idstring
Unique Identifier of the property- Example:
2sFZqWxJuynYnwLHg
- Example:
timezonestring
Property timezone- Example:
Asia/Singapore
- Example:
Response body
errorstring
Response body
errorstring
No example response recorded for this status code.
Get Property Detail
https://api.igloohome.co/home/properties/{propertyId}Returns info on a property
Path Parameters
| Parameter | Type | Required |
|---|---|---|
| propertyId | string | Yes |
Request Example
Responses
OK
Unauthorized, invalid or expired authorization token
Response
Forbidden. accessToken scope must contain 'igloohomeapi/get-properties'
Property Not Found
Internal Server Error
Response body
payloadobjectnamestring
Name of the property- Example:
Singapore HQ
- Example:
idstring
Unique Identifier of the property- Example:
2sFZqWxJuynYnwLHg
- Example:
timezonestring
Property timezone- Example:
Asia/Singapore
- Example:
Response body
errorstring
No example response recorded for this status code.
Get Devices by Property ID
https://api.igloohome.co/home/properties/{propertyId}/devicesReturns a list of devices of given property. Devices include locks, as well as non-lock devices.
| Device Type |
|---|
| Lock |
| Keypad |
| Bridge |
| Fob |
Path Parameters
| Parameter | Type | Required |
|---|---|---|
| propertyId | string | Yes |
Query Parameters
cursorstring
The pagination cursor.cursoris a string ID that marks your place in the list. For instance, if you make a list request and receive 100 objects, withnextCursorof2sThyA1jii6WmTo3j, your next call can includecursor=2sThyA1jii6WmTo3jin order to fetch the next page of the list.limitnumber<int32>
Number of objects to return, from 1 to 300. Defaults to 100.- Constraints:
>= 1,<= 300 - Default:
100 - Example:
30
- Constraints:
sortstring
Order in which to return objects. Defaults todesc.- Default:
desc - Allowed values:
asc,desc
- Default:
Request Example
Responses
OK
Bad Request
Unauthorized, invalid or expired authorization token
Response
Forbidden, accessToken scope must contain 'igloohomeapi/get-devices'
Internal Server Error
Response body
nextCursorstring
A string pointing to the next page of results. Empty string indicates you reached the end of the list- Example:
2sThyA1jii6WmTo3j
- Example:
payloadarray of object
An array containing the return devicesidstring
Internal batch identifier of the device- Example:
2rqQx4Riasw3Rs6db01
- Example:
typestring
Device Type- Example:
Keypad
- Example:
deviceIdstring
Unique Identifier of the device- Example:
EK1X013f300d
- Example:
deviceNamestring
Name of the device- Example:
My keypad 1
- Example:
batteryLevelinteger
Battery level of the devicepairedAtstring<date-time>
Pairing date- Example:
2022-05-30T00:00:00+08:00
- Example:
homeIdarray of string
Associated home/property(s)- Example:
["2rqQx4Riasw3Rs6db"]
- Example:
linkedDevicesarray of object
Device(s) linked to this device- Example:
[{"type":"Lock"},{"deviceId":"IGP102c1854a"}] idstring
Internal batch identifier of the linked devicetypestringdeviceIdstring
- Example:
Response body
errorstring
Response body
errorstring
No example response recorded for this status code.