Projects

List publicly accessible preset energy datums for a project

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

get

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

Authorizations

Path parameters

projectIdstringrequired

The project ID

Query parameters

presetstring · enumrequired

The preset configuration to get datums by

Options: week, day

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.ecosuite.io//public/energy/datums/projects/{projectId}?preset=week' \
  --header 'Authorization: YOUR_API_KEY'

200

400

200

{
  "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-02-23T23:07:50.734Z",
    "localEndDate": "2025-02-23T23:07:50.734Z"
  },
  "aggregation": "year"
}

successful operation