External API

Building engineering data through the BuildingData API

Connect dispatch systems, analytics and enterprise applications to BuildingData. Work with Sites, Equipment, Points, current values, history, semantic relationships, anomalies, KPIs, incidents and work orders through one API.

API Reference Swagger OpenAPI JSON

HTTPS · Bearer authentication · read-only

API resources

Sites

Sites, Equipment and normalized Points.

Current values

Value, timestamp, quality and engineering unit.

History

Point history with raw data and 1m, 5m, 15m and 1h aggregation.

Semantics

Published Site semantic model and engineering relationships.

Analytics

Anomalies and Site KPI summaries.

Operations

Incidents and work orders.

Connect

Get a credential BuildingData issues a credential scoped to the approved Sites.

Authenticate Send the credential in Authorization: Bearer <client_id>.<client_secret>.

Start with Sites Request GET /v1/sites, then load Equipment, Points and data.

First request

Example request after receiving a credential.

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

Access

The API is served over HTTPS and provides read-only data access. Each credential has its own permissions and Site scope. For production integrations, keep client_secret on your backend or BFF.