Building EUI API

Computes building Energy Use Intensity (kWh/m2/yr and kBtu/ft2/yr) from annual energy and floor area, with an optional benchmark comparison. Answers 'What is the EUI for 150000 kWh over 1000 m2?', 'How does this building compare to its benchmark?'.

Price$0.04per request

MethodPOST

Route/v1/climate/energy-use-intensity

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

euienergy-use-intensitybuildingefficiencykbtusustainabilitybenchmarkfacilities

API URLhttps://x402.hexl.dev/v1/climate/energy-use-intensity

Integration docs

Example request

{
  "annualEnergyKwh": 150000,
  "floorAreaM2": 1000,
  "benchmarkEuiKwhM2": 120
}

Example response

{
  "euiKwhM2": 150,
  "euiKbtuFt2": 47.55,
  "annualEnergyKwh": 150000,
  "floorAreaM2": 1000,
  "benchmarkEuiKwhM2": 120,
  "pctVsBenchmark": 25,
  "comparison": "25% above benchmark",
  "interpretation": "EUI 150 kWh/m²/yr (47.5 kBtu/ft²/yr), 25% above benchmark.",
  "formula": "EUI = annual energy / floor area; IP: kBtu/ft² = kWh·3.412142 / (m²·10.7639)"
}

Input schema

{
  "type": "object",
  "required": [
    "annualEnergyKwh",
    "floorAreaM2"
  ],
  "properties": {
    "annualEnergyKwh": {
      "type": "number",
      "description": "Annual energy use (kWh)",
      "examples": [
        150000
      ]
    },
    "floorAreaM2": {
      "type": "number",
      "description": "Gross floor area (m2)",
      "examples": [
        1000
      ]
    },
    "benchmarkEuiKwhM2": {
      "type": "number",
      "description": "Optional benchmark EUI (kWh/m2/yr)",
      "examples": [
        120
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}