Query Building Emissions

Building Emissions refers to a building’s carbon emissions based on different energy types, expressed in metric tons of carbon dioxide equivalent (CO₂e). This data can be obtained from the API using the fetchBuildingEmissions query.

Query Request

From your app or API client, use the below URL:

URL: https://api.abound.carrier.io/prod-ahs-api/graphql/

Argument:

  • buildingId: 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 buildingId.

QUERY
                    
                      
query {
  fetchBuildingEmissions(buildingId: "f8a7b2d3", years: [2024]) {
    electricity {
      value
    }
    gas {
      value
    }
    period {
      from
      to
    }
    totalEmission
  }
}
Response
                    
                      {
"data": {
"fetchBuildingEmissions": [
{
"electricity": {
"value": 0
},
"gas": {
"value": 0
},
"period": {
"from": "2024-01-02T00:00:00.000Z",
"to": "2024-01-02T00:00:00.000Z"
},
"totalEmission": 0
}
]
}
}