Skip to main content

Historical Consumption

Get actual measured consumption data of all devices of a certain timeframe:
cURL
If you are interested in real-time energy consumption in kWh, we recommend to query the endpoint every 15 minutes for the past 15minutes timeframe. Our consumption data is provided in 15-minute granularity at quarter hours. We recommend to query the endpoint with quarter hour timestamps (e.g. 16:00, 16:15, 16:30, etc.) for the past 15 minutes timeframe to get the most up-to-date data. If you query shorter than 15 minutes in the past, you might already see a record for the current quarter hour timestamp but the consumption value might still update until the end of the quarter hour. You should not rely on this as having per minute granularity consumption data. If you are interested in aggregated consumption data across all devices, you can use the aggregated=true query parameter to get the aggregated consumption across all devices. If you are not interested in aggregated data but on a per device basis, you should use the query parameter device_id to get the consumption data on a per device basis. Another option is to query without providing the device_id query parameter but loop over the same api call using the next_token query parameter to paginate through the data of all devices. We would only recommend this option if you are interested in all devices data and if your timeframe you are querying is small (e.g. 15minutes) as the amount of data can become quite large if you query a long timeframe and have many devices. More info about the /device/consumption/historical endpoint.

Forecasted Consumption

Get forecasted (= nominated) consumption data for all devices of a certain timeframe:
cURL
This endpoint works very similar as the /device/consumption/historical endpoint. We recommend you to read the explanation at historical consumption first. The biggest difference in this endpoint is that it also contains forecasted data for the future. This is data forecasting 1-2 days starting from the next day. How far in the future and when the forecasted data is provided, depends on your needs. Example: If you wants us to provide forecasted data at 11 AM CET everyday for the next day. Then the data will be provided at 11 AM CET and the data contained will be from 00:00 UTC until 23:45 UTC of the next day. We recommend to use a 24h timeframe at the agreed forecast generation time with a device_id query parameter. More info about the /device/consumption/forecast/historical endpoint.

Typical Consumption

Get baseline consumption:
cURL
This endpoint works very similar as the /device/consumption/historical endpoint. We recommend you to read the explanation at historical consumption first. The biggest difference in this endpoint is that it contains data of at least 1 day ago. This is data generated at 3 AM UTC for the full previous UTC day. More info about the /device/typical-consumption/historical endpoint.