Get Real-time Desk Occupancy for a Floor

This API returns the desk occupancy for all desk sensors on a floor.

For the sensors to report occupancy data, you will need licenses based on the number of sensors. You will need to purchase Sensor and API licenses to get real-time desk occupancy for all desks on a floor. Refer to the License Types and Product Codes.   

Also, before using this API call, ensure that all desk sensors are assigned to 'Desk Sensor' Fixture Type. See article Enable Desk Sensors to assign 'Desk Sensor' Fixture Type to sensors. 

Request

GET https://{em_ip_address_or_hostname}/ems/api/org/sensor/v1/getDeskOccupancyState/list/floor/{floor_id}

Parameters

Sample Code

For example, if Floor 1 has three desk sensors, the occupancy status for all three desk sensors on Floor 1 is returned.

Get https://192.80.3.1/ems/api/org/sensor/v1/getDeskOccupancyState/list/floor/1

HTTP/1.1 200 OK
Server: Apache-Coyote/1.1
Content-Type: application/xml
Content-Length: 7582
Date: Sat, 21 Jul 2015 17:06:51 GMT
{
    "deskSensor": [
        {
            "id": "70",
            "name": "Sensor71bd6a",
            "occupancyState": "0"
        },
        {
            "id": "71",
            "name": "Sensor71af2a",
            "occupancyState": "0"
        },
        {
            "id": "72",
            "name": "Sensor71b13e",
            "occupancyState": "1"
        }
    ]
}