API for customer applications and integrators

Normalized building engineering data through one API

Connect custom dispatch systems, operations workstations, analytics and enterprise services to Customer Central. Protocols, Nodes and normalization stay below the API while applications work with Sites, Equipment, Points and history.

Open Swagger OpenAPI JSON

v1 · read-only · scoped Bearer access

How data moves through BuildingData

BMS / SCADA / PLC Building-side sources

BuildingData Node Collection and local resilience

Project Haystack Normalization and relationships

Customer Central Storage and engineering context

External API v1 Stable external contract

Your application Dispatch, operations, analytics, integrations

Available now

Sites and equipment

Sites, Equipment and normalized Points.

Current values

Timestamp, quality, numeric or text value and engineering unit.

History

Raw values and 1m, 5m, 15m, 1h aggregation.

Semantics

Published immutable Site model with Project Haystack context.

Anomalies and KPIs

Site health, affected points and evidence.

Operations

Read-only incidents and work orders from Customer Central.

First request

Use your issued credential to request the Sites available to your integration.

curl \
  -H 'Authorization: Bearer <client_id>.<client_secret>' \
  https://api.buildingdata.ru/v1/sites

Access boundary

Each credential is limited by permissions and Organization/Site scope. Internal IAM, Global Engineering, Node lifecycle, TimescaleDB, Haxall and industrial protocols are not exposed through this API.

Batch queries, cursor pagination and near-real-time delivery belong to the next API phase and are not part of the current contract.