# Authenticatie, invoer en resultaat ## Vraag een duurzaamheidsadvies aan op basis van adres. `POST` `https://api.altum.ai/v2/sustainability/delta` Met dit endpoint kun je een reactie ontvangen van de **Altum AI Sustainability Delta API** over de duurzaamheid en de Ecowaarde, op basis van postcode, huisnummer en eventuele toevoeging. #### Headers | Naam | Type | Omschrijving | | ------------------------------------------- | ------ | ------------------------------------------------------------------------------------ | | Content-Type | string | Applicatie/json | | x-api-key\* | string | Unieke API sleutel van Altum. Maak er één aan via Mopsus () | #### Request Body | Naam | Type | Omschrijving | Voorbeeld | | --------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | postcode\* | string | Zes-cijferige postcode formaat | 1234AB | | housenumber\* | int | Huisnummer van het object | 5 | | houseaddition | string | Huisnummertoevoeging | C | | build\_year | int | Bouwjaar | 1956 | | roof\_type | int | Daktype |

1 = (voornamelijk) schuin dak

2 = (voornamelijk) plat dak

3 = deels schuin, deels plat dak

| | inner\_surface\_area | float | De totale woonoppervlakte (m²) | 90 | | house\_type | int | Woningtype |

1 = vrijstaande woning

2 = 2-onder-1-kapwoning

3 = hoekwoning

4 = tussenwoning

| | wall\_insulation | int | Bekijk [Measures](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-delta/broken-reference) | 2 | | target\_wall\_insulation | int | Bekijk [Measures](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-delta/broken-reference) | 4 | | floor\_insulation | int | Bekijk [Measures](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-delta/broken-reference) | 1 | | target\_floor\_insulation | int | Bekijk [Measures](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-delta/broken-reference) | 4 | | sloped\_roof\_insulation | int | Bekijk [Measures](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-delta/broken-reference) | 2 | | target\_sloped\_roof\_insulation | int | Bekijk [Measures](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-delta/broken-reference) | 4 | | flat\_roof\_insulation | int | Bekijk [Measures](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-delta/broken-reference) | 2 | | target\_flat\_roof\_insulation | int | Bekijk [Measures](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-delta/broken-reference) | 4 | | living\_room\_windows | int | Bekijk [Measures](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-delta/broken-reference) | 1 | | target\_living\_room\_windows | int | Bekijk [Measures](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-delta/broken-reference) | 3 | | bedroom\_windows | int | Bekijk [Measures](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-delta/broken-reference) | 1 | | target\_bedroom\_windows | int | Bekijk [Measures](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-delta/broken-reference) | 4 | | installation | int | Bekijk [Measures](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-delta/broken-reference) | 4 | | target\_installation | int | Bekijk [Measures](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-delta/broken-reference) | 4 | | shower | int | Bekijk [Measures](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-delta/broken-reference) | 1 | | target\_shower | int | Bekijk [Measures](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-delta/broken-reference) | 2 | | ventilation | int | Bekijk [Measures](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-delta/broken-reference) | 2 | | target\_ventilation | int | Bekijk [Measures](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-delta/broken-reference) | 3 | | solar\_panels | list | Bekijk [Measures](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-delta/broken-reference) | | | cooling | int | Is er een koelsysteem aanwezig? |

1 = Geen koeling

2 = Airconditioning, directe luchtkoeling

| | target\_cooling | int | Is er een koelsysteem aanwezig? |

1 = Geen koeling

2 = Airconditioning, directe luchtkoeling

| | electric\_cooking | int | Wat wordt gebruikt om te koken? |

1 = Gasfornuis

2 = Elektrisch fornuis

Als de installatie in \[6,7] zit -> 2 anders 1

| | target\_electric\_cooking | int | Wat wordt gebruikt om te koken? |

1 = Gasfornuis

2 = Elektrisch fornuis

Als de installatie in \[6,7] zit -> 2,
anders standaard 1

| | inhabitants | int | Aantal bewoners | 4 | | gas\_usage | float | Overschrijft het geschatte jaarlijkse gasverbruik (m³) | 1000 | | heat\_usage | float | Overschrijft het opgegeven jaarlijkse warmteverbruik (GJ) | 45 | | electricity\_usage | float | Overschrijft het opgegeven jaarlijkse elektriciteitsverbruik (kWh) | 2600 | | electricity\_generation | float |

Totale jaarlijkse elektriciteitsopbrengst van zonnepanelen (kWh)
Netto verbruik = verbruik − opbrengst

| 800 | | exclude\_vat | boolean | Prijzen zijn inclusief of exclusief btw. |

0 = Inclusief btw

1 = Exclusief btw

Standaard: 0

| | cost\_indicators | dict | Bekijk [Costs](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-delta/broken-reference) | | | wall\_filters | dict | Bekijk [Measure filters](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-delta/broken-reference) | | | sloped\_roof\_filters | dict | Bekijk [Measure filters](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-delta/broken-reference) | | | flat\_roof\_filters | dict | Bekijk [Measure filters](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-delta/broken-reference) | | | floor\_filters | dict | Bekijk [Measure filters](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-delta/broken-reference) | | | fetch\_definitive\_label | int | Ophalen van het definitieve energielabel uit EP-online |

0 = Uitschakelen

1 = Inschakelen

Standaard: 0

| | eco\_delta | boolean | Ophalen van de Ecowaarde |

0 = Uitschakelen

1 = Inschakelen

Standaard: 1

| {% tabs %} {% tab title="200: OK succesvol resultaat" %} ``` { "warnings": [], "address": { "housenumber": 87, "postcode": "2771DS", "houseaddition": null, "street": "Zuidkade", "city": "Boskoop", "location": { "lat": 52.06839381665532, "lon": 4.65808526945334 } }, "building": { "build_year": 1961, "inner_surface": 131, "floor_surface": 80.8, "flat_roof_surface": 5.2, "pitched_roof_surface": 98.9, "wall_surface": 126.1, "glass_living_room_surface": 11.1, "glass_bedrooms_surface": 16.6, "number_of_doors": 6, "type": "vrijstaand" }, "label": { "current": "D", "potential": "D" }, "provided_label": { "temporary": "F", "definitive": "C", "definitive_type": null, "definitive_validity": null }, "BENG1": { "current": null, "potential": null }, "BENG2": { "current": 265, "potential": 251 }, "meta": null, "energyindex": { "current": null, "potential": null }, "ELG": { "current": null, "potential": null }, "comfortscore": { "current": null, "potential": null }, "CO2": { "current": 2633, "potential": 2179 }, "financial": { "total_investment": 1554, "total_saving": 69, "months_to_pay_off": 270, "eco_value": 0, "savings_monthly": 6, "energy_cost_monthly": { "current": 232, "potential": 227 }, "energy_cost_yearly": { "current": 2789, "potential": 2720 }, "return_on_investment": "-0.14%", "loan": { "monthly_payment": 6 } }, "gas_usage": { "current": 1697, "potential": 1697 }, "electricity_usage": { "current": 3262, "potential": 3262 }, "city_heating_usage": { "current": 0, "potential": 0 }, "solar_panel_yield": { "current": 4445, "potential": 5778 }, "energy_prices": { "variable_gas_price": null, "variable_electricity_price": null, "solarpanel_watt_peak_per_m2": null }, "solar_panels": { "current": [ { "roof_surface": 0, "roof_type": null, "original_watt_peak_capacity": null, "total_watt_peak_capacity": 2000, "current_specific_watt_peak": 250, "added_watt_peak_capacity": null, "specific_watt_peak_of_added_panels": null, "added_panels": null, "inclination_angle": 45, "orientation": 180 }, { "roof_surface": 1, "roof_type": null, "original_watt_peak_capacity": null, "total_watt_peak_capacity": 3000, "current_specific_watt_peak": 150, "added_watt_peak_capacity": null, "specific_watt_peak_of_added_panels": null, "added_panels": null, "inclination_angle": 45, "orientation": 180 } ], "potential": [ { "roof_surface": 0, "roof_type": null, "original_watt_peak_capacity": null, "total_watt_peak_capacity": 2500, "current_specific_watt_peak": null, "added_watt_peak_capacity": null, "specific_watt_peak_of_added_panels": 250, "added_panels": 1, "inclination_angle": 45, "orientation": 180 }, { "roof_surface": 1, "roof_type": null, "original_watt_peak_capacity": null, "total_watt_peak_capacity": 4000, "current_specific_watt_peak": null, "added_watt_peak_capacity": null, "specific_watt_peak_of_added_panels": 200, "added_panels": 3, "inclination_angle": 45, "orientation": 180 } ] }, "measures": { "wall_insulation": { "before": { "desc": "Geen", "value": 1, "points": 2 }, "after": { "desc": "Geen", "value": 1, "points": 2 }, "investment": 0, "savings": 0, "co2_reduce": 0, "BENG2": "0", "gas_savings": 0, "electricity_savings": 0 }, "floor_insulation": { "before": { "desc": "Geen", "value": 1, "points": 0 }, "after": { "desc": "Geen", "value": 1, "points": 0 }, "investment": 0, "savings": 0, "co2_reduce": 0, "BENG2": "0", "gas_savings": 0, "electricity_savings": 0 }, "sloped_roof_insulation": { "before": { "desc": "Geen", "value": 1, "points": 0 }, "after": { "desc": "Geen", "value": 1, "points": 0 }, "investment": 0, "savings": 0, "co2_reduce": 0, "BENG2": "0", "gas_savings": 0, "electricity_savings": 0 }, "flat_roof_insulation": { "before": { "desc": "Geen", "value": 1, "points": 0 }, "after": { "desc": "Geen", "value": 1, "points": 0 }, "investment": 0, "savings": 0, "co2_reduce": 0, "BENG2": "0", "gas_savings": 0, "electricity_savings": 0 }, "living_room_windows": { "before": { "desc": "Dubbel glas", "value": 2, "points": 1 }, "after": { "desc": "Dubbel glas", "value": 2, "points": 1 }, "investment": 0, "savings": 0, "co2_reduce": 0, "BENG2": "0", "gas_savings": 0, "electricity_savings": 0 }, "bedroom_windows": { "before": { "desc": "Dubbel glas", "value": 2, "points": null }, "after": { "desc": "Dubbel glas", "value": 2, "points": null }, "investment": 0, "savings": 0, "co2_reduce": 0, "BENG2": "0", "gas_savings": 0, "electricity_savings": 0 }, "installation": { "before": { "desc": "HR-combi ketel", "value": 4, "points": 15 }, "after": { "desc": "HR-combi ketel", "value": 4, "points": 15 }, "investment": 0, "savings": 0, "co2_reduce": 0, "BENG2": "0", "gas_savings": 0, "electricity_savings": 0 }, "shower": { "before": { "desc": "Geen Douche WTW", "value": 1, "points": null }, "after": { "desc": "Geen Douche WTW", "value": 1, "points": null }, "investment": 0, "savings": 0, "co2_reduce": 0, "BENG2": "0", "gas_savings": 0, "electricity_savings": 0 }, "cooling": { "before": { "desc": "No cooling", "value": 1, "points": null }, "after": { "desc": "No cooling", "value": 1, "points": null }, "investment": 0, "savings": 0, "co2_reduce": 0, "BENG2": "0", "gas_savings": 0, "electricity_savings": 0 }, "ventilation": { "before": { "desc": "Natuurlijk", "value": 1, "points": 0 }, "after": { "desc": "Natuurlijk", "value": 1, "points": 0 }, "investment": 0, "savings": 0, "co2_reduce": 0, "BENG2": "0", "gas_savings": 0, "electricity_savings": 0 }, "solar_panels": { "before": { "desc": "5000", "value": 5000, "points": null }, "after": { "desc": "6500", "value": 6500, "points": null }, "investment": 1554, "savings": 69, "co2_reduce": 453, "BENG2": "99", "gas_savings": 0, "electricity_savings": 1334 }, "electric_cooking": { "before": { "desc": "Gas stove", "value": 1, "points": null }, "after": { "desc": "Gas stove", "value": 1, "points": null }, "investment": 0, "savings": 0, "co2_reduce": 0, "BENG2": "0", "gas_savings": 0, "electricity_savings": 0 } }, "response_meta": null } ``` {% endtab %} {% endtabs %}