Skip to content

Get Sensor Details by Floor API

Returns sensor details for all sensors on the floor for a given period at every five-minute interval. For example, sensor data is sent at every five-minute interval if the duration is from 10:00 am to 10:10 am. The API retrieves data for a maximum period of one hour.

Request

GET https://{em_ip_address_or_hostname}/ems/api/org/sensor/v2/stats/floor/{floor_id}/{from_date}/{to_date}

Parameters

Request

NameDescription
em_ip_address_or_hostnameThe Enlighted Manage (EM) IP address or hostname.
floor_idFloor identifier. Use the Floor ID returned in the Get All Floors API, or in Manage, select Facility > Floor in the left panel, and click the Settings tab to obtain the Floor ID.
from_dateStart date to display energy consumption data. Format: (yyyyMMddHHmm) year/month/day/hour/minutes
to_dateEnd date to stop displaying energy consumption data. Format: (yyyyMMddHHmm) year/month/day/hour/minutes

Response

NameDescription
IdFixture identifier (used as the primary identifier in other API calls)
powerThe average load of the fixture in watts for the last five-minute interval
temperatureTemperature in Fahrenheit
lightLevelAmbient light level reading at the sensor (lux). See Ambient Status for details. NOTE: The unit level measurement of light striking the Enlighted Sensor lens is an approximation of Lux.
avgDimLevelAverage fixture dim level represents light level where there is sufficient light for the occupants. If the sensor is not connected to any lighting fixture, the API call returns a value of -1.
lastCommunicationtimeTime of last sensor communication (YYYY-MM-DD 24HH-MM)
captureTimeFive-minute time duration represented as (yyyy-MM-dd HH:mm) year-month-day-hour-minutes

Sample Request

Request sensor details for all sensors on the first floor with Floor ID ‘1’ from 10 am through 11:30 am on Feb. 12, 2019. Data will be sent at every five-minute interval, which will be 10:05 am and 10:10 am, and so on.

GET https://192.80.3.2/ems/api/org/sensor/v2/stats/floor/1/201902120100/201902120200

Sample Response

{
 "sensor": [
    {
      "id": "28", 
      "power": "27.98",
      "temperature": "78",
      "lightLevel": "773",
      "avgDimLevel": "85",
      "lastCommunicationTime": "2019-02-12 10:12",
      "captureTime": "2019-02-12 10:05"
    },
    {
       "id": "29", 
       "power": "12.62",
       "temperature": "74",
       "lightLevel": "593",
       "avgDimLevel": "85",
       "lastCommunicationTime": "2019-02-12 10:12",
        "captureTime": "2019-02-12 10:10"
    },
],
 "sensor": [
    {
       "id": "1327",
       "power": "27.98",
       "temperature": "74",
       "lightLevel": "99",
       "avgDimLevel": "85",
       "lastCommunicationTime": "2019-02-12 10:12",
        "captureTime": "2019-02-12 10:15"
    },
    {
        "id": "1377",
        "power": "12.62",
        "temperature": "70",
        "lightLevel": "462",
        "avgDimLevel": "75",
        "lastCommunicationTime": "2019-02-12 10:12",
        "captureTime": "2019-02-12 10:20"     
    }
  ]
}