Skip to content

Real-time Desk Occupancy for a Floor

This API detects and returns if a desk is occupied or unoccupied with area information from Enlighted desk sensors.

For the sensors to report occupancy data, you will need licenses based on the number of sensors. Purchase both the 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 all desk sensors are assigned to the 'Desk Sensor' Fixture Type. See the article Enable Desk Sensors to assign 'Desk Sensor' Fixture Type to sensors.


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


Name Description
em_ip_address_or_hostname Manage’s IP address or hostname
floor_id Floor identifier. Use the Get All Floors API, or in EM, select Facility > Floor > in the left panel, and click the Settings tab to obtain the Floor ID.
id The fixture or sensor identifier.
name Sensor name.
occupancyState 0 – Desk Unoccupied
1 – Desk Occupied
-1 – Fault. Sensors are not reporting occupancy.

Sample Request

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


Sample Response

    "deskSensor": [
            "id": "70",
            "name": "Sensor71bd6a",
            "occupancyState": "0"
            "id": "71",
            "name": "Sensor71af2a",
            "occupancyState": "0"
            "id": "72",
            "name": "Sensor71b13e",
            "occupancyState": "1"


Connect and Collaborate with Industrial Professionals and Join the Community!

Click to load comments