Projects

List publicly accessible preset energy datums for a project

get

List publicly accessible preset energy datums for a project, providing access to a set span of recent datums

Authorizations

ecogy-auth-cognito-dev

AuthorizationstringRequired

Path parameters

projectIdstringRequired

The project ID

Query parameters

presetstring · enumRequired

The preset configuration to get datums by

Possible values:

Responses

200

successful operation

application/json

400

Invalid status value

application/json

get

/public/energy/datums/projects/{projectId}

HTTPcURLJavaScriptPython

GET /public/energy/datums/projects/{projectId}?preset=week HTTP/1.1
Host: api.ecosuite.io/
Authorization: YOUR_API_KEY
Accept: */*

{
  "project": {
    "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-12-16T13:20:33.792Z",
    "localEndDate": "2025-12-16T13:20:33.792Z"
  },
  "aggregation": "year"
}