Skip to main content
PATCH
Update Energy Profile
Saves one or more answers about the energy setup at a location. Send only the fields you want to change: fields you leave out keep their value, and null clears a field. The first request creates the profile, so you can save each answer as soon as the user gives it. Prices are in euro per kWh including VAT: a number from 0 to 5 with at most 5 decimals.
string
required
The UUID of the location.
boolean
Whether the location has solar panels.
boolean
Whether the location has a home battery.
boolean
Whether the user would like solar panels. Only kept while has_solar_panels is false: saving has_solar_panels as true clears it, also when both are sent in the same request.
boolean
Whether the user would like a home battery. Only kept while has_home_battery is false: saving has_home_battery as true clears it, also when both are sent in the same request.
string
The electricity contract. One of fixed, variable or dynamic.
string
The energy supplier. Maximum 100 characters.
number
The price per kWh. For a fixed or variable contract, the normal or single rate.
number
The off-peak (low) rate per kWh.
array
When the off-peak rate applies, in the location’s own time: at most 14 blocks, each with days (ISO days, 1 for Monday to 7 for Sunday), from and to (HH:MM). A block whose to is before from runs past midnight; from equal to to is the whole day. For example [{"days": [1, 2, 3, 4, 5], "from": "23:00", "to": "07:00"}, {"days": [6, 7], "from": "00:00", "to": "00:00"}].
number
What the user gets per kWh fed back to the grid.
number
For a dynamic contract, the supplier’s markup per kWh on the day-ahead price.
boolean
Send true when the user has finished answering. The first time, this sets completed_at to the current time; later requests keep that first time. false is not accepted.

Response

Returns 200 with the whole profile, also when the request created it.
object
The energy profile of the location.