Projects

List the energy datums for a project

get

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

Authorizations

ecogy-auth-cognito-dev

Path parameters

projectIdstringRequired

The ID of the project

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

400

Invalid status value

application/json

get

/energy/datums/projects/{projectId}

HTTPcURLJavaScriptPython

GET /energy/datums/projects/{projectId}?start=2025-10-31T18%3A12%3A43.954Z&end=2025-10-31T18%3A12%3A43.954Z HTTP/1.1
Host: api.ecosuite.io/
Authorization: YOUR_API_KEY
Accept: */*

{
  "projectDatums": {
    "code": "text",
    "name": "text",
    "peakConsumption": 1,
    "peakGeneration": 1,
    "aggregatedTotals": [
      {
        "ANY_ADDITIONAL_PROPERTY": {
          "generation": 1,
          "generationReading": 1,
          "normalisedGeneration": 1,
          "consumption": 1,
          "consumptionReading": 1,
          "export": 1,
          "exportReading": 1,
          "storage": 1,
          "storageReading": 1,
          "forecast48Consumption": 1,
          "forecast12Consumption": 1,
          "forecast24Consumption": 1,
          "forecastConsumption": 1
        }
      }
    ],
    "sources": [
      {
        "ANY_ADDITIONAL_PROPERTY": {
          "reading": 1,
          "peakReading": 1
        }
      }
    ],
    "sites": {
      "ANY_ADDITIONAL_PROPERTY": {
        "code": "text",
        "name": "text",
        "peakConsumption": 1,
        "peakGeneration": 1,
        "aggregatedTotals": [
          {
            "ANY_ADDITIONAL_PROPERTY": {
              "generation": 1,
              "generationReading": 1,
              "normalisedGeneration": 1,
              "consumption": 1,
              "consumptionReading": 1,
              "export": 1,
              "exportReading": 1,
              "storage": 1,
              "storageReading": 1,
              "forecast48Consumption": 1,
              "forecast12Consumption": 1,
              "forecast24Consumption": 1,
              "forecastConsumption": 1
            }
          }
        ],
        "sources": [
          {
            "ANY_ADDITIONAL_PROPERTY": {
              "reading": 1,
              "peakReading": 1
            }
          }
        ],
        "systems": {
          "ANY_ADDITIONAL_PROPERTY": {
            "code": "text",
            "name": "text",
            "peakConsumption": 1,
            "peakGeneration": 1,
            "aggregatedTotals": [
              {
                "ANY_ADDITIONAL_PROPERTY": {
                  "generation": 1,
                  "generationReading": 1,
                  "normalisedGeneration": 1,
                  "consumption": 1,
                  "consumptionReading": 1,
                  "export": 1,
                  "exportReading": 1,
                  "storage": 1,
                  "storageReading": 1,
                  "forecast48Consumption": 1,
                  "forecast12Consumption": 1,
                  "forecast24Consumption": 1,
                  "forecastConsumption": 1
                }
              }
            ],
            "sources": [
              {
                "ANY_ADDITIONAL_PROPERTY": {
                  "reading": 1,
                  "peakReading": 1
                }
              }
            ]
          }
        }
      }
    }
  },
  "range": {
    "localStartDate": "2025-10-31T18:12:43.954Z",
    "localEndDate": "2025-10-31T18:12:43.954Z"
  },
  "aggregation": "year"
}