Migration Guide: v1 → v2

This page provides an overview of the changes required when migrating from v1 to v2 of the API.

1. Request Body Changes

v1

{
    "post_code": "2771DS",
    "house_number": "87",
    "house_addition": ""
}

v2

{
    "postcode": "2771DS",
    "housenumber": "87",
    "houseaddition": ""
}

2. Input Changes

a. Basic Features

New Inputs

• roof_type

• electric_cooking

• cooling

Renamed Inputs

• roof_insulation → sloped_roof_insulation

• roof_insulation → flat_roof_insulation

Solar Panel Input Changes

The solar_panels structure has changed from a single integer value to a list describing individual solar panel installations.

New solar panel related fields include:

• solar_panels (list per installation)

• pv_total_watt_peak

• pv_area

• specific_watt_peak

• angle

• orientation

• free_roof_area

• roof_type

pv_area replaces the previous field:

• solar_panels_surface

3. Output Changes

The response structure now includes additional fields and updated naming.

Renamed Outputs

• roof_insulation → sloped_roof_insulation

• roof_insulation → flat_roof_insulation

New Outputs

• cooling

• electric_cooking

• solar_panels (per solar panel)

• roof_surface

• roof_type

Solar Panel Metrics

Additional solar metrics are now included in the response:

• original_watt_peak_capacity

• total_watt_peak_capacity

• added_watt_peak_capacity

• added_panels

• inclination_angle

• orientation

4. Feature Value Changes

The value range for several features has changed.

Previously these values ranged from 0–3, but they now range from 1–4.

Affected features include:

• wall_insulation

• floor_insulation

• flat_roof_insulation

• sloped_roof_insulation

• living_room_windows

• bedroom_windows

Example

v1

1 = mediocre wall insulation

v2

2 = mediocre wall insulation