The chat responses are generated using Generative AI technology for intuitive search and may not be entirely accurate. They are not intended as professional advice. For full details, including our use rights, privacy practices and potential export control restrictions, please refer to our Generative AI Service Terms of Use and Generative AI Service Privacy Information. As this is a test version, please let us know if something irritating comes up. Like you get recommended a chocolate fudge ice cream instead of an energy managing application. If that occurs, please use the feedback button in our contact form!
Skip to content
Enlighted

The Enlighted lighting solution optimizes energy savings while enhancing occupant productivity, well-being, and security.

Aggregate Sensor Energy Data by Floor¶

Enlighted Manage software v4.4 release and above supports this API.

This API returns the total energy consumption in watt-hour for all fixtures on the floor. Users can retrieve energy consumption data for up to forty-five days. The energy data is pre-aggregated in fifteen-minute intervals (96 records per day), adhering to most measurement and verification (M&V) reporting standards.

Request¶

GET https://{em_ip_address_or_hostname}/ems/api/org/facility/v2/facilityEnergyStatsOfFloor/15min/floor/{floor_id}/{from_date}/{to_date}?page={page}

Parameters¶

Request¶

ParameterDescription
em_ip_address_or_hostnameManage’s IP address or hostname
floor_idFloor 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.
from_dateStart date to display energy consumption data. Format: (yyyyMMddHHmmss). year/month/day/hour/minutes/seconds.
to_dateEnd date to stop displaying energy consumption data. Format: (`yyyyMMDDHHmmss). year/month/day/hour/minutes/seconds.
pageThe requested page number. Each page displays 96 records corresponding to 24 hours of energy consumption data. For example, when a user requests 30 days of energy consumption data, the 15th page will have the energy consumption details for the 15th day of the requested period.

Response¶

ParameterDescription
idFloor Identifier.
nameFloor name
intervalStartTime from when data is retrieved (YYYY-MM-DDTHHLMM:SS{+/-GMT})
baseenergyDisplays the baseline energy consumption in watt-hour of the fixtures. The difference between baseEnergy and energy is savedEnergy. Base energy is the amount of energy the fixtures will consume if their dimLevel was 100% for the entire period; energy will never be greater than baseEnergy.
energyThe energy consumed by all fixtures in watt-hour on the floor for the period.
savedEnergyThe energy saved by the fixtures in watt-hour on the floor for the period. - savedEnergy = baseEnergy - energy; -savedEnergy = occSavings + ambientSavings + manual Savings
occSavingsFixture energy savings from baseline when lights are switched off due to vacancy.
ambientSavingsFixture energy savings from baseline when lights are dimmed due to available ambient daylight.
manualSavingsFixture energy savings from baseline when lights are manually controlled.

Sample Request¶

Using the Floor ID '1' returned by the Get All Floors API, request the aggregate energy consumption for fixtures on the floor from 5:30am on Feb. 12, 2019 to 5:30am on Feb. 19, 2019. The sample response shows details returned for fixtures on the floor for the specified time period for page 2 (Feb. 13, 5:30am to Feb. 14, 5:30am).

GET https://192.80.3.2/ems/api/org/facility/v2/facilityEnergyStatsoffloor/15min/floor/1/20190212053000/20190219053000?page=2

Sample Response¶

{

  "facilityEnergyStats": [

  {

      "id": "1",
      "intervalStart":"2019-02-13T05:30:00+05:30",
      "name":         "7th   Floor",
      "baseEnergy":   "38.85",
      "energy":       "16.00",
      "savedEnergy":  "22.85",
      "occSavings":   "16.20",
      "ambientSavings":"0.00",
      "tuneupSavings": "6.65",
      "manualSavings":"0.00"
  },

  {

      "id": "1",
      "intervalStart":"2019-02-13T05:45:00+05:30",
      "name":         "7th   Floor",
      "baseEnergy":   "38.85",
      "energy":       "16.00",
      "savedEnergy":  "22.85",
      "occSavings":   "16.20",
      "ambientSavings":"0.00",
      "tuneupSavings": "6.65",
      "manualSavings":"0.00"
  },

  {

      "id": "1",
      "intervalStart":"2019-02-13T06:00:00+05:30",
      "name":         "7th   Floor",
      "baseEnergy":   "38.85",
      "energy":       "16.00",
      "savedEnergy":  "22.85",
      "occSavings":   "16.20",
      "ambientSavings":"0.00",
      "tuneupSavings": "6.65",
      "manualSavings":"0.00"
  },

  {

      "id": "1",
      "intervalStart":"2019-02-13T06:15:00+05:30",
      "name":         "7th   Floor",
      "baseEnergy":   "38.85",
      "energy":       "16.00",
      "savedEnergy":  "22.85",
      "occSavings":   "16.20",
      "ambientSavings":"0.00",
      "tuneupSavings": "6.65",
      "manualSavings":"0.00"
  },
  { 

      "id": "1",
      "intervalStart":"2019-02-13T06:30:00+05:30",
      "name":         "7th   Floor",
      "baseEnergy":   "38.85",
      "energy":       "16.00",
      "savedEnergy":  "22.85",
      "occSavings":   "16.20",
      "ambientSavings":"0.00",
      "tuneupSavings": "6.65",
      "manualSavings":"0.00"
  },
  ]
}