Projects

List the forecast consumption energy datums for a project

get

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

Authorizations
Path parameters
projectIdstringRequired

The ID of the project to get the datums for

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
get
GET //energy/datums/consumption/predicted/projects/{projectId} HTTP/1.1
Host: api.ecosuite.io
Authorization: YOUR_API_KEY
Accept: */*
{
  "projectDatums": {
    "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": "2025-09-16T10:57:29.528Z",
    "localEndDate": "2025-09-16T10:57:29.528Z"
  },
  "aggregation": "year"
}