Sign in

v2

latestOpenAPI 3.1.02026-08-04252295.1 KB
Intake

Estimate a Consumption Profile from an Energy Profile

Models a yearly Consumption Profile for the requested energy type(s) — gas, electricity, or both — from a household Energy Profile (family size, heat pump, EVs, solar panels, battery). Used when no measured consumption is available. The response carries one Consumption Profile per requested energy type. familySize is always required; the electricity-only fields are required when energyTypes includes ELECTRICITY.

post/v1/estimations

Request body

energyTypesstring[] required

Which energy types to estimate. One or both of ELECTRICITY, GAS. Each requested type yields a Consumption Profile under the matching key in the response.

familySize'1' | '2' | '3' | '4' | '>5' required

Household size band. Always required (both gas and electricity estimates use it).

hasHeatPumpboolean

Whether the household has a heat pump. Required when energyTypes includes ELECTRICITY; ignored for a gas-only estimate.

evCountinteger

Number of electric vehicles. Required when energyTypes includes ELECTRICITY; ignored for a gas-only estimate.

solarPanelCountinteger

Number of solar panels (0 if none). Required when energyTypes includes ELECTRICITY; ignored for a gas-only estimate.

hasBatteryboolean

Whether the household has a home battery. Required when energyTypes includes ELECTRICITY; ignored for a gas-only estimate.

Response

Default Response