Query Energy Use Intensity

Building Energy Use Intensity (EUI) is the amount of energy used per unit of building area and provides a reference point to compare a facility to other facilities with similar uses.

Query Request

From your app or API client, use the below URL: URL: https://api.abound.carrier.io/prod-ahs-api/graphql/

Argument: 

  • spaceId: Unique ID of the building. Building IDs can be obtained using the getNodeByType query.
  • years: Specify the year for which you are requesting data

Query Response

As a response, the above query will fetch details about various assets for the entire building based on the specified spaceId.

QUERY
                    
                      
{
  "energyUseIntensity": {
    "options": {
      "spaceId": "f8a7b2d3-1c5e-4f9b-9d4f-0a8c2e3d7b6a",
      "years": [2024]
    },
    "areaUnit": null,
    "billingPeriod": {
      "from": null,
      "to": null
    },
    "electricity": {
      "energyUseIntensity": null,
      "spendIntensity": null,
      "type": null,
      "unit": null
    },
    "gas": {
      "energyUseIntensity": null,
      "spendIntensity": null,
      "type": null,
      "unit": null
    },
    "water": {
      "energyUseIntensity": null,
      "type": null,
      "unit": null
    }
  }
}
RESPONSE
                    
                      
{
  "data": {
    "energyUseIntensity": [
      {
        "areaUnit": "Feet_Squared",
        "billingPeriod": {
          "from": "2024-01-02T00:00:00.000Z",
          "to": "2024-01-02T00:00:00.000Z"
        },
        "electricity": {
          "energyUseIntensity": 0,
          "spendIntensity": 0,
          "type": "electricity",
          "unit": "kWh"
        },
        "gas": {
          "energyUseIntensity": 0,
          "spendIntensity": 0,
          "type": "gas",
          "unit": "Therms"
        },
        "water": {
          "energyUseIntensity": null,
          "type": "water",
          "unit": "Gallons"
        }
      }
    ]
  }
}