REST & WebSockets API

API Reference

Integrate Probiz Energy AI directly with your enterprise ERP, custom dashboards, or field edge devices using standard REST endpoints.

Bearer Token Authentication

Pass your API key in the Authorization header: Authorization: Bearer pbz_live_xxx

POST/v1/telemetry/ingest

Ingest Sensor Telemetry

Stream real-time sensor metrics (temperature, kW power, flow rate, pressure) from edge gateways to Probiz Cloud.

{
  "gateway_id": "gw-blr-tower-04",
  "timestamp": "2026-09-08T21:45:00Z",
  "metrics": [
    { "sensor_id": "hvac_ahu_01_temp", "val": 22.4, "unit": "C" },
    { "sensor_id": "chiller_02_kw", "val": 145.8, "unit": "kW" },
    { "sensor_id": "main_grid_pf", "val": 0.97, "unit": "pf" }
  ]
}

GET/v1/devices/status

Get Gateway & Sensor Status

Fetch connected gateway operational status, signal quality, and telemetry polling health scores.

// Response (200 OK)
{
  "gateways": [
    {
      "id": "gw-blr-tower-04",
      "status": "ONLINE",
      "uptime_pct": 99.98,
      "connected_sensors": 480,
      "protocol": "BACnet IP"
    }
  ]
}

PUT/v1/hvac/setpoint

Update HVAC Setpoint

Send closed-loop setpoint adjustments to AHUs, Chillers, or VAV boxes with optional manual override duration.

{
  "asset_id": "ahu_zone_3b",
  "target_temp_c": 23.0,
  "override_mode": "AI_AUTO",
  "duration_minutes": 120
}

GET/v1/analytics/energy-summary

Get Energy Consumption Summary

Retrieve aggregated consumption, peak demand spikes, baseline forecast, and cost estimation for specified building zones.

// Response (200 OK)
{
  "facility_id": "fac-bengaluru-hq",
  "period": "LAST_24_HOURS",
  "total_kwh": 14250.5,
  "savings_pct": 34.2,
  "co2_saved_kg": 11400
}