Query Weather Normalized Baseline

Use the getWnbDataByDateRange query to get utility consumption and spend set against a weather normalized baseline. This data can be used by facility managers to evaluate energy consumption and spend relative to local weather conditions.

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.
  • currency: Currency code for the building represented using the ISO 4217 standard
  • fromDate: The starting point in time from which to retrieve alarms. This will be in an ECMAScript date time string format - YYYY-MM-DD YYYY-MM-DDTHH:mm:ss.sssZ
  • toDate: The ending point in time from which to retrieve alarms. This will be in an ECMAScript date time string format - YYYY-MM-DD | YYYY-MM-DDTHH:mm:ss.sssZ

Query Response

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

QUERY
                    
                      
{
  getWnbDataByDateRange(
    buildingId: "f8a7b2d3-1c5e-4f9b-9d4f-0a8c2e3d7b6a"
    currency: "USD"
    fromDate: "2022-06-01"
    toDate: "2023-05-31"
  ) {
    wnbId
    buildingId
    disabled
    utilityType
    correlationCoefficient
    rSquared
    fromDate
    toDate
    intercept
    slope
    tippingTempUnit
    coolingTippingTemp
    heatingTippingTemp
    updatedAt
    monthlyExpectedUtilityUsage {
      month
      spend {
        amount
        currency
      }
      consumption {
        expectedMonthlyTotal
        unit
      }
      energy {
        expectedMonthlyTotal
        unit
      }
    }
  }
}
RESPONSE
                    
                      
{
  "data": {
    "getWnbDataByDateRange": [
      {
        "wnbId": "86360df9-e6bb-4dc2-8dc8-30024f505e6e",
        "buildingId": "f8a7b2d3-1c5e-4f9b-9d4f-0a8c2e3d7b6a",
        "disabled": false,
        "utilityType": "electricity",
        "correlationCoefficient": -0.92,
        "rSquared": 0.85,
        "fromDate": "2022-06-01",
        "toDate": "2023-05-31",
        "intercept": 15021.448128603639,
        "slope": -2499.6726969891192,
        "tippingTempUnit": "Fahrenheit",
        "coolingTippingTemp": 85,
        "heatingTippingTemp": 60,
        "updatedAt": "1711668203264",
        "monthlyExpectedUtilityUsage": [
          {
            "month": 1,
            "spend": {
              "amount": 0,
              "currency": "USD"
            },
            "consumption": {
              "expectedMonthlyTotal": 449417.02,
              "unit": "kWh"
            },
            "energy": {
              "expectedMonthlyTotal": 1533410.87,
              "unit": "kBtu"
            }
          },
          {
            "month": 2,
            "spend": {
              "amount": 49185.8,
              "currency": "USD"
            },
            "consumption": {
              "expectedMonthlyTotal": 433622.26,
              "unit": "kWh"
            },
            "energy": {
              "expectedMonthlyTotal": 1479519.15,
              "unit": "kBtu"
            }
          },
          {
            "month": 3,
            "spend": {
              "amount": 52820.38,
              "currency": "USD"
            },
            "consumption": {
              "expectedMonthlyTotal": 465664.89,
              "unit": "kWh"
            },
            "energy": {
              "expectedMonthlyTotal": 1588848.6,
              "unit": "kBtu"
            }
          }
        ]
      }
    ]
  }
}