Aggregate Building Energy Consumption¶
The API retrieves the aggregate energy consumption in watt-hour for all fixtures and plugloads in the building for the last 15 minutes managed by Enlighted Manage (EM) server.
For example, if the request has been sent between 10:05:00 and 10:19:59 am, energy data is sent from 9:45 to 10:00 am. Likewise, if the request is between 10:20:00 and 10:34:59, data is sent from 10:00 to 10:15 am. The data is aggregated at 5-minute intervals and rounded to the nearest last 15-minute interval set.
Request¶
GET https://{em_ip_address_or_hostname}/ems/api/org/em/v1/energy/
Parameters¶
| Name | Description |
|---|---|
| Request | |
| em_ip_address_or_hostname | Manage’s IP address or hostname |
| Response | |
| energy-lighting: | Reports aggregate energy consumption in watt-hour (Wh) for the last 15 minutes for all lighting fixtures managed by Manage |
| energy-plugload: | Reports aggregate energy consumption in watt-hour (Wh) for the last 15 minutes for all plugloads managed by Manage |
Sample Request¶
Obtain the aggregate energy consumption for all lighting fixtures and plugloads in the building for the last 15 minutes.
GET https://{192.80.3.2}/ems/api/org/em/v1/energy/
Sample Response¶
{
"energy-lighting": "21550.96",
"energy-plugload": "3650.64"
}