curl --fail-with-body --silent --show-error --get \
--header "Authorization: Bearer ${MINSTROEM_API_TOKEN}" \
--data-urlencode "from=2026-09-05T10:00:00Z" \
--data-urlencode "to=2026-09-05T11:00:00Z" \
--data-urlencode "aggregation=hour" \
"https://api.minstroem.app/consumer/v1/me/addresses/${MINSTROEM_ADDRESS_ID}/consumption"{
"addressId": "2b4bf7a8-b5d0-45ab-8d42-3a5688bba167",
"from": "2026-09-05T10:00:00Z",
"to": "2026-09-05T11:00:00Z",
"aggregation": "hour",
"timeZone": "Europe/Copenhagen",
"data": [
{
"start": "2026-09-05T10:00:00Z",
"end": "2026-09-05T11:00:00Z",
"energyKWh": 2,
"isEstimate": false
}
]
}Get consumption
Get electricity consumption. Hourly requests cover up to 366 days; daily, monthly, or yearly requests cover up to five years. Limits apply after range normalization.
curl --fail-with-body --silent --show-error --get \
--header "Authorization: Bearer ${MINSTROEM_API_TOKEN}" \
--data-urlencode "from=2026-09-05T10:00:00Z" \
--data-urlencode "to=2026-09-05T11:00:00Z" \
--data-urlencode "aggregation=hour" \
"https://api.minstroem.app/consumer/v1/me/addresses/${MINSTROEM_ADDRESS_ID}/consumption"{
"addressId": "2b4bf7a8-b5d0-45ab-8d42-3a5688bba167",
"from": "2026-09-05T10:00:00Z",
"to": "2026-09-05T11:00:00Z",
"aggregation": "hour",
"timeZone": "Europe/Copenhagen",
"data": [
{
"start": "2026-09-05T10:00:00Z",
"end": "2026-09-05T11:00:00Z",
"energyKWh": 2,
"isEstimate": false
}
]
}GET /consumer/v1/me/addresses/{addressId}/consumption?from={from}&to={to}&aggregation={aggregation}
Authorizations
API key created in the iOS app. Requires an active Min Strøm Plus subscription.
Path Parameters
Address ID returned by List addresses.
Query Parameters
Inclusive RFC 3339 start with Z or numeric offset. Fractions accepted. Expanded outward to the interval. UTC instant encoded with Z. Interval ends are exclusive.
"2026-09-05T10:00:00Z"
Exclusive RFC 3339 end after from. Expands outward unless aligned. Caps apply after expansion. UTC instant encoded with Z. Interval ends are exclusive.
"2026-09-05T10:00:00Z"
Time interval for grouping readings.
hour, day, month, year Response
Available readings in time order. Results may contain gaps or be empty.
UTC instant encoded with Z. Interval ends are exclusive.
"2026-09-05T10:00:00Z"
UTC instant encoded with Z. Interval ends are exclusive.
"2026-09-05T10:00:00Z"
hour, day, month, year Calendar used for interval boundaries: Europe/Copenhagen. Timestamps are UTC.
"Europe/Copenhagen"
Ascending sparse rows; empty is valid. Gaps are not zero readings.
Show child attributes
Show child attributes