Predicted

List the forecast consumption energy datums for all projects

get

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

Authorizations

ecogy-auth-cognito-dev

AuthorizationstringRequired

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

200

successful operation

application/json

aggregationstring · enumOptionalPossible values:

400

Invalid status value

application/json

get

/energy/datums/consumption/predicted

HTTPcURLJavaScriptPython

GET /energy/datums/consumption/predicted?start=2026-03-23T19%3A29%3A47.207Z&end=2026-03-23T19%3A29%3A47.207Z HTTP/1.1
Host: api.ecosuite.io/
Authorization: YOUR_API_KEY
Accept: */*

{
  "projects": {
    "ANY_ADDITIONAL_PROPERTY": {
      "predictedConsumption": 1,
      "historicConsumption": 1,
      "targetConsumption": 1,
      "aggregatedTotals": {
        "ANY_ADDITIONAL_PROPERTY": {
          "predictedConsumption": 1,
          "historicConsumption": 1,
          "targetConsumption": 1
        }
      },
      "sites": {
        "ANY_ADDITIONAL_PROPERTY": {
          "predictedConsumption": 1,
          "historicConsumption": 1,
          "targetConsumption": 1,
          "aggregatedTotals": {
            "ANY_ADDITIONAL_PROPERTY": {
              "predictedConsumption": 1,
              "historicConsumption": 1,
              "targetConsumption": 1
            }
          },
          "systems": {
            "ANY_ADDITIONAL_PROPERTY": {
              "predictedConsumption": 1,
              "historicConsumption": 1,
              "targetConsumption": 1,
              "sources": {
                "ANY_ADDITIONAL_PROPERTY": {
                  "predictedConsumption": 1,
                  "historicConsumption": 1,
                  "targetConsumption": 1
                }
              },
              "aggregatedTotals": {
                "ANY_ADDITIONAL_PROPERTY": {
                  "predictedConsumption": 1,
                  "historicConsumption": 1,
                  "targetConsumption": 1
                }
              }
            }
          }
        }
      }
    }
  },
  "range": {
    "localStartDate": "2026-03-23T19:29:47.207Z",
    "localEndDate": "2026-03-23T19:29:47.207Z"
  },
  "aggregation": "year"
}