---
title: "Estimate a Consumption Profile from an Energy Profile"
method: POST
path: "/v1/estimations"
tags: ["Intake"]
---

# Estimate a Consumption Profile from an Energy Profile

`POST /v1/estimations`

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.

## Request body

- object
  - `energyTypes` string[], 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).
  - `hasHeatPump` boolean — Whether the household has a heat pump. Required when energyTypes includes ELECTRICITY; ignored for a gas-only estimate.
  - `evCount` integer — Number of electric vehicles. Required when energyTypes includes ELECTRICITY; ignored for a gas-only estimate.
  - `solarPanelCount` integer — Number of solar panels (0 if none). Required when energyTypes includes ELECTRICITY; ignored for a gas-only estimate.
  - `hasBattery` boolean — Whether the household has a home battery. Required when energyTypes includes ELECTRICITY; ignored for a gas-only estimate.

## Response `200`

Default Response

- EstimationResult — Estimated Consumption Profile per requested energy type. A key is present only when that energy type was requested in energyTypes.
  - `electricity` ElectricityConsumptionProfile — Modelled yearly usage figures for an electricity supply point: total and time-banded consumption (kWh), injection (kWh), monthly peak power (kW) and inverter capacity (kVA).
    - `consumptionTotalKwh` number, required — Total yearly consumption in kWh.
    - `consumptionDayKwh` number, nullable, required — Day-band consumption in kWh. Null for a single-rate meter.
    - `consumptionNightKwh` number, nullable, required — Night-band consumption in kWh. Null for a single-rate meter.
    - `injectionTotalKwh` number, nullable, required — Total yearly injection in kWh (solar surplus fed back). Null when there are no solar panels.
    - `injectionDayKwh` number, nullable, required — Day-band injection in kWh. Null without solar.
    - `injectionNightKwh` number, nullable, required — Night-band injection in kWh. Null without solar.
    - `peakConsumptionKw` number, nullable, required — Monthly peak power in kW.
    - `inverterCapacityKva` number, nullable, required — Inverter capacity in kVA.
  - `gas` GasConsumptionProfile — Modelled yearly gas usage: a total consumption in kWh. Gas has no time bands, injection or meter figures.
    - `consumptionTotalKwh` number, required — Total yearly gas consumption in kWh.

---

[API](https://skmtc.dev/vwala/apis/energy-platform-api.md) · [All operations](https://skmtc.dev/vwala/apis/energy-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vwala/energy-platform-api/revisions/86688c4fea92/schema)