Skip to content

Get All Buildings API

Retrieve the list of all buildings on the campus for the organization, including the Building ID and Building details.

Request

GET https://{em_ip_address_or_hostname}/ems/api/org/building/list/{campus_id}

Parameters

Request

NameDescription
em_ip_address_or_hostnameThe Enlighted Manage (EM) IP address or hostname
campus_idThe ID of the campus for which all buildings will be returned

Response

NameDescription
idBuilding identifier from Manage
nameBuilding name as described in Manage
useOrgLocationFor internal use
visibleFor internal use
useOrgLocationTzFor internal use
energySaveCalcMethodEnergy savings calculated based on the sensor’s baseline energy or contract baseline energy.
SENSOR_BASED – Savings based on the sensor’s baseline energy
CONTRACTUAL – Savings based on contract baseline energy. The contract baseline energy is calculated using the annual baseline energy savings stipulated in the customer’s signed agreement for the campus at the time of installation.
contractBaselineBaseline energy savings for the campus

Sample Request

Send a GET request to return the list of all buildings for the campus ID. Details are returned as an object response if a single building is available on the campus. If more than one building is available on the campus, details are returned as an array response.

In the example below, the campus has a single building called ‘Main Building’ and its details are returned as shown.

GET https://192.80.3.2/ems/api/org/building/list/3

Sample Response

{
   "building": {
       "id": "4",
       "name": "Main Building",
       "useOrgLocation": "true",
       "visible": "true",
       "useOrgLocationTz": "true",
       "energySaveCalcMethod": "SENSOR_BASED",
       "contractBaseline": "0.00"
   }
}

When a campus has two buildings: ‘Main 5’ and 'Main 6', their details are returned as shown below.

 GET https://192.80.3.2/ems/api/org/building/list/4
{
   "building": [
  {
       "id": "5",
       "name": "Main 5",
       "useOrgLocation": "true",
       "visible": "true",
       "useOrgLocationTz": "true",
       "energySaveCalcMethod": "SENSOR_BASED",
       "contractBaseline": "0.00"
   },
   {
       "id": "6",
       "name": "Main 6",
       "useOrgLocation": "true",
       "visible": "true",
       "useOrgLocationTz": "true",
       "energySaveCalcMethod": "SENSOR_BASED",
       "contractBaseline": "0.00"
   }
]
}