Cost

List the consumption cost datums for all projects

get

List the consumption cost datums for a specified date range and aggregate for all projects

Authorizations

Query parameters

startstring · date-timeRequired

The inclusive start date

endstring · date-timeRequired

The exclusive end date

aggregationstring · enumOptional

The aggregation to group the datums by

Possible values:

Responses

get

HTTPcURLJavaScriptPython

GET //energy/datums/consumption/cost HTTP/1.1
Host: api.ecosuite.io
Authorization: YOUR_API_KEY
Accept: */*

{
  "projects": {
    "ANY_ADDITIONAL_PROPERTY": {
      "consumptionCost": {
        "totalCost": 1,
        "totalMeteredCost": 1,
        "totalDemandCharge": 1,
        "totalFixedCost": 1,
        "aggregatedTotals": [
          {
            "meteredCost": 1,
            "demandCharge": 1,
            "fixedCost": 1
          }
        ],
        "sites": {
          "ANY_ADDITIONAL_PROPERTY": {
            "totalCost": 1,
            "totalMeteredCost": 1,
            "totalDemandCharge": 1,
            "totalFixedCost": 1,
            "aggregatedTotals": [
              {
                "meteredCost": 1,
                "demandCharge": 1,
                "fixedCost": 1
              }
            ],
            "systems": {
              "ANY_ADDITIONAL_PROPERTY": {
                "totalCost": 1,
                "totalMeteredCost": 1,
                "totalDemandCharge": 1,
                "totalFixedCost": 1,
                "aggregatedTotals": [
                  {
                    "meteredCost": 1,
                    "demandCharge": 1,
                    "fixedCost": 1
                  }
                ]
              }
            }
          }
        }
      }
    }
  },
  "range": {
    "localStartDate": "2025-04-30T08:25:45.391Z",
    "localEndDate": "2025-04-30T08:25:45.391Z"
  },
  "aggregation": "year"
}