DemandFlow Support Centre

BUILDING: Building

A building within a site containing floors, with power, cooling, security, and compliance tracking.

Default definition. This article describes the default BUILDING definition shipped with DemandFlow. Administrators can add, remove, rename, or re-type fields, change which ones are required, and alter the layout from the Definitions screen in Settings. Your tenant's current schema may differ from what is shown here. To read the current definition at any time, GET the DEFINITION object whose id matches BUILDING.

Entity properties

Property	Value
Entity code	`BUILDING`
Display name	Building
Plural	Buildings
Level	45000

Use cases

BUILDING is the second level in the physical hierarchy (SITE > BUILDING > FLOOR > ROOM > RACK). Each building belongs to a parent SITE via objectLookup, and its status and type reuse the SITESTATUS and SITETYPE lookups since buildings share similar lifecycle states and classifications. Location fields (address, lat/lon, position description) allow buildings at different addresses within a campus site, with a map view. Physical attributes track area, floor count, height, construction type (BUILDCONST lookup), seismic rating, and renovation history.

Fields

General

Field	Type	Required	Notes
`name`	text	Yes	Name.
`buildingId`	text		Building ID.
`buildingCode`	text		Building Code.
`status`	reference → `SITESTATUS`		Building status.
`buildingtype`	reference → `SITETYPE`		Building type.
`site`	reference → `SITE`	Yes	Parent Site.
`description`	text (multi-line)		Description.

General: Location

Field	Type	Notes
`pri_add_street1`	text	Street 1.
`pri_add_street2`	text	Street 2.
`pri_add_city`	text	City.
`pri_add_county`	text	County.
`pri_add_postcode`	text	Postcode.
`pri_add_country`	reference → `COUNTRY`	Country.
`lat`	number	Latitude.
`lon`	number	Longitude.
`position`	text (multi-line)	Description of building location within site

Attributes: Physical Attributes

Field	Type	Notes
`totalArea`	number	Total Building Area (sq ft).
`usableArea`	number	Usable Area (sq ft).
`whiteSpaceArea`	number	White Space Area (sq ft).
`floorCount`	number	Number of Floors.
`buildingHeight`	number	Building Height (m).
`constructionType`	reference → `BUILDCONST`	Construction Type.
`seismicRating`	text	Seismic Rating.
`yearBuilt`	number	Year Built.
`lastRenovated`	date	Last Renovated.

Attributes: Capacity

Field	Type	Notes
`totalPowerCapacity`	number	Total Power Capacity (kW).
`availablePowerCapacity`	number	Available Power (kW).
`totalRackCapacity`	number	Total Rack Capacity.
`availableRackCapacity`	number	Available Rack Capacity.
`totalCoolingCapacity`	number	Total Cooling Capacity (tons).
`availableCoolingCapacity`	number	Available Cooling (tons).

Utilities & Services: Power Systems

Field	Type	Notes
`primaryPowerSource`	reference → `POWER`	Primary Power Source.
`powerFeedCount`	number	Number of Power Feeds.
`powerDistribution`	text (multi-line)	Power Distribution Notes.

Utilities & Services: Cooling Systems

Field	Type	Notes
`coolingSystemType`	reference → `COOLING`	Cooling System Type.
`coolingArchitecture`	reference → `COOLARCH`	Cooling Architecture.
`coolingNotes`	text (multi-line)	Cooling System Notes.

Contacts: Building contacts

Field	Type	Notes
`contact_manager`	reference → `PPL`	Building Manager.
`contact_facilities`	reference → `PPL`	Facilities Contact.
`contact_security`	reference → `PPL`	Security Contact.
`contact_emergency`	reference → `PPL`	Emergency Coordinator.

Contacts: Documentation

Field	Type	Notes
`floorPlanUrl`	text (URL)	URL to building floor plans
`structuralDrawingsUrl`	text (URL)	URL to structural drawings
`electricalSchematicsUrl`	text (URL)	URL to electrical schematics
`mechanicalDrawingsUrl`	text (URL)	URL to mechanical drawings
`lifeSafetyPlansUrl`	text (URL)	URL to life safety plans

Security & Access: Security Systems

Field	Type	Notes
`buildingSecurityLevel`	enum	Building Security Level. Valid ids: `1` (Low), `2` (Medium), `3` (High), `4` (Maximum).
`accessControlSystem`	array of references → `BUILDSEC`	Access Control Systems.
`videoSurveillance`	enum	Video Surveillance Coverage. Valid ids: `1` (None), `2` (Perimeter Only), `3` (Main Areas), `4` (Comprehensive).
`securityStaffing`	enum	Security Staffing. Valid ids: `1` (None), `2` (Business Hours Only), `3` (24x7).

Security & Access: Access Information

Field	Type	Notes
`primaryEntranceLocation`	text	Primary Entrance Location.
`loadingDockLocation`	text	Loading Dock Location.
`accessHours`	enum	Access Hours. Valid ids: `1` (Business Hours Only), `2` (Extended Hours), `3` (24x7), `4` (By Appointment).
`accessNotes`	text (multi-line)	Access Notes.

Compliance: Building Certifications

Field	Type	Notes
`energyStarRating`	number	Energy Star Rating.
`leedCertification`	enum	LEED Certification. Valid ids: `1` (None), `2` (Certified), `3` (Silver), `4` (Gold), `5` (Platinum).
`buildingCodeCompliance`	text	Building Code Compliance.
`certificateOfOccupancy`	date	Certificate of Occupancy Date.
`lastInspectionDate`	date	Last Building Inspection.
`nextInspectionDate`	date	Next Scheduled Inspection.
`complianceNotes`	text (multi-line)	Compliance Notes.

Maintenance: Maintenance Information

Field	Type	Notes
`maintenanceSchedule`	text (multi-line)	Maintenance Schedule.
`lastMaintenanceDate`	date	Last Maintenance Date.
`nextMaintenanceDate`	date	Next Maintenance Date.
`maintenanceProvider`	reference → `COM`	Maintenance Provider.

Maintenance: Building Warranties

Field	Type	Notes
`roofWarrantyExpiry`	date	Roof Warranty Expiry.
`hvacWarrantyExpiry`	date	HVAC Warranty Expiry.
`electricalWarrantyExpiry`	date	Electrical Systems Warranty Expiry.
`buildingWarrantyNotes`	text (multi-line)	Warranty Notes.

Disaster Recovery: Building Safety Systems

Field	Type	Notes
`fireDetectionSystem`	reference → `FIREDET`	Fire Detection System.
`fireSuppType`	reference → `FIRESUP`	Fire Suppression Type.
`emergencyResponsePlan`	text (URL)	URL to emergency response plan document
`emergencyEvacuationPlan`	text (URL)	URL to evacuation plan document

Disaster Recovery: Backup Systems

Field	Type	Notes
`backupPowerType`	reference → `POWER`	Backup Power Type.
`backupPowerCapacity`	number	Backup Power Capacity (kW).
`backupCoolingType`	reference → `COOLING`	Backup Cooling Type.
`backupCoolingCapacity`	number	Backup Cooling Capacity (tons).

Operational Metrics: Building Efficiency

Field	Type	Notes
`buildingPue`	number	Building PUE.
`buildingEnergyUse`	number	Energy Usage (kWh/month).
`buildingDcu`	number	Percentage of available capacity in use

Operational Metrics: Building Cost Metrics

Field	Type	Notes
`buildingOperationalCost`	number	Monthly Operational Cost.
`buildingMaintenanceCost`	number	Monthly Maintenance Cost.
`buildingEnergyCost`	number	Monthly Energy Cost.

Relationships

Lookups: status points at a SITESTATUS record; buildingtype points at a SITETYPE record; site points at a SITE record; pri_add_country points at a COUNTRY record; constructionType points at a BUILDCONST record; primaryPowerSource points at a POWER record; coolingSystemType points at a COOLING record; coolingArchitecture points at a COOLARCH record; contact_manager points at a PPL record; contact_facilities points at a PPL record; contact_security points at a PPL record; contact_emergency points at a PPL record; accessControlSystem points at a BUILDSEC record; maintenanceProvider points at a COM record; fireDetectionSystem points at a FIREDET record; fireSuppType points at a FIRESUP record; backupPowerType points at a POWER record; backupCoolingType points at a COOLING record.
Related lists: FLOOR, POWERMETER (via building).

Creating a Building via the API

POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json

{
  "entity":   "BUILDING",
  "level":    45000,
  "comboKey": "SUB:<your-sub-id>|ENT:",
  "name": "Name",
  "site": "",
  "description": "Description",
  "buildingId": "Building ID"
}

Listing Buildings records

GET /v1/entities/BUILDING/SUB

DemandFlow Support Centre

BUILDING: Building

BUILDING: Building

Entity properties

Use cases

Fields

Relationships

Creating a Building via the API

Listing Buildings records

See also

Was this article helpful?