Mapped to the system model
API calls stay anchored to real system objects.
/projects/{id}/buildings
Start with operating scope before drilling into one site or stakeholder boundary.
/buildings/{id}/devices
Discover the hardware estate without needing vendor-specific lookup logic.
/devices/{id}/datapoints
Inspect what can be queried, streamed, controlled, and scored for quality.
/stream/devices/{id}
Subscribe to live telemetry using the same object graph and permission model.
{
"device_id": "meter-019",
"type": "smart_meter",
"data_type": "electricity",
"readings": [
{
"timestamp": "2026-03-15T14:00:00Z",
"value": 16.3,
"unit": "kWh"
}
],
"health_score": 0.95
}
REST for historical access. WebSocket for live telemetry. The platform keeps both views anchored to the same object model, quality envelope, and governance contract.