Authenticatie, invoer en resultaat

Vraag een duurzaamheidsadvies op basis van het adres.

POST https://api.altum.ai/v2/sustainability/apartments/delta

Met deze endpoint ontvang je een antwoord van de Altum AI Verduurzaming API Delta, speciaal voor appartementen, over duurzaamheid en de Ecovalue, door postcode, huisnummer en huisletter/toevoeging mee te geven.

Headers

Naam	Type	Omschrijving
Content-Type	string	application/json
x-api-key*	string	Unieke API sleutel van Altum. Maak er één aan via Mopsus (https://mopsus.altum.ai)

Request Body

Naam	Type	Omschrijving	Voorbeeld
postcode*	string	Zes-cijferige postcode formaat	1234AB
housenumber*	integer	Huisnummer van het object	5
houseaddition	string	Huisnummertoevoeging	C
position	integer	1 = 'Hoek begane grond' 2 = 'Tussenwoning begane grond' 3 = 'Hoekwoning middenverdieping' 4 = 'Tussenwoning middenverdieping' 5 = 'Hoekwoning bovenste verdieping' 6 = 'Tussenwoning bovenste verdieping' 7 = 'Volledig bovenste verdieping/penthouse'	3
floors	integer	Heeft de woning één of meerdere verdiepingen? 1 = 'Eén verdieping' 2 = 'Meerdere verdiepingen'	1
back_facade	boolean	Heeft de woning een achtergevel? Nee (false) Ja (true)	false
build_year	integer	Bouwjaar	1956
inner_surface_area	float	Totale woonoppervlakte (m²)	90
apartment_type	integer	1 = 'Galerijflat' 2 = 'Portiekflat' 3 = 'Corridorflat' 4 = 'Maisonnette' 5 = 'Benedenwoning' 6 = 'Bovenwoning' 7 = 'Portiekwoning
wall_insulation	integer	see Measures	2
target_wall_insulation	integer	see Measures	4
floor_insulation	integer	see Measures	1
target_floor_insulation	integer	see Measures	4
sloped_roof_insulation	integer	see Measures	2
target_sloped_roof_insulation	integer	see Measures	4
flat_roof_insulation	integer	see Measures	2
target_flat_roof_insulation	integer	see Measures	4
living_room_windows	integer	see Measures	1
target_living_room_windows	integer	see Measures	3
bedroom_windows	integer	see Measures	1
target_bedroom_windows	integer	see Measures	4
installation	integer	see Measures	4
target_installation	integer	see Measures	4
shower	integer	see Measures	1
target_shower	integer	see Measures	2
ventilation	integer	see Measures	2
target_ventilation	integer	see Measures	3
solar_panels	list	see Measures
cooling	integer	Is er een koelsysteem aanwezig?	1 = Geen koeling 2 = Airconditioning, directe luchtkoeling
target_cooling	integer	Is er een koelsysteem aanwezig?	1 = Geen koeling 2 = Airconditioning, directe luchtkoeling
electric_cooking	integer	Wat wordt gebruikt om te koken?	1 = Gasfornuis 2 = Elektrisch fornuis Als de installatie in [6,7] zit -> 2 anders 1
target_electric_cooking	integer	Wat wordt gebruikt om te koken?	1 = Gasfornuis 2 = Elektrisch fornuis Als de installatie in [6,7] zit -> 2 anders 1
inhabitants	integer	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	see Cost indicators
wall_filters	dict	see Measure filters
roof_filters	dict	see Measure filters
floor_filters	dict	see Measure filters
fetch_definitive_label	integer	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

Voor de meest nauwkeurige resultaten is het aan te raden zowel de positie als het aantal verdiepingen van het appartement op te geven.

200: OK Successful response

{
  "tip": null,
  "warnings": [
    {
      "code": "11",
      "description": "Current building with energy label C already meets default target_label A."
    }
  ],
  "address": {
    "housenumber": 227,
    "postcode": "3024XL",
    "houseaddition": "B",
    "street": "Willem Buytewechstraat",
    "city": "Rotterdam",
    "location": {
      "lat": 51.90761152288453,
      "lon": 4.451398538183942
    }
  },
  "building": {
    "build_year": 1927,
    "inner_surface": 74,
    "floor_surface": 0,
    "roof_surface": 0,
    "wall_surface": 50.2,
    "glass_living_room_surface": 13.4,
    "number_of_doors": 5,
    "floors": "Single",
    "main_type": "Appartement",
    "sub_type": null
  },
  "label": {
    "current": "C",
    "potential": "B"
  },
  "provided_label": {
    "temporary": "G",
    "definitive": null,
    "definitive_type": null,
    "definitive_validity": null
  },
  "BENG2": {
    "current": 245,
    "potential": 181
  },
  "meta": null,
  "CO2": {
    "current": 2357,
    "potential": 2141
  },
  "financial": {
    "total_investment": 2309,
    "total_saving": 164,
    "months_to_pay_off": 168,
    "eco_value": 0,
    "savings_monthly": 14,
    "energy_cost_monthly": {
      "current": 175,
      "potential": 161
    },
    "energy_cost_yearly": {
      "current": 2096,
      "potential": 1932
    },
    "return_on_investment": "0.52%",
    "loan": {
      "monthly_payment": 10
    }
  },
  "gas_usage": {
    "current": 888,
    "potential": 769
  },
  "electricity_usage": {
    "current": 2262,
    "potential": 2255
  },
  "city_heating_usage": {
    "current": 0,
    "potential": 0
  },
  "solar_panel_yield": {
    "current": 0,
    "potential": 0
  },
  "energy_prices": {
    "variable_gas_price": 1.359,
    "variable_electricity_price": 0.27,
    "solarpanel_watt_peak_per_m2": 250
  },
  "solar_panels": {
    "current": null,
    "potential": null
  },
  "measures": {
    "wall_insulation": {
      "before": {
        "desc": "Geen",
        "value": 1,
        "points": 2
      },
      "after": {
        "desc": "Goed",
        "value": 3,
        "points": 5
      },
      "investment": 2309,
      "savings": 164,
      "co2_reduce": 215,
      "BENG2": "100",
      "gas_savings": 119,
      "electricity_savings": 7
    },
    "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
    },
    "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": "Enkel glas",
        "value": 1,
        "points": 0
      },
      "after": {
        "desc": "Enkel glas",
        "value": 1,
        "points": 0
      },
      "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": "Natuurlijke ventilatie",
        "value": 1,
        "points": 0
      },
      "after": {
        "desc": "Natuurlijke ventilatie",
        "value": 1,
        "points": 0
      },
      "investment": 0,
      "savings": 0,
      "co2_reduce": 0,
      "BENG2": "0",
      "gas_savings": 0,
      "electricity_savings": 0
    },
    "solar_panels": {
      "before": {
        "desc": "0",
        "value": 0,
        "points": null
      },
      "after": {
        "desc": "0",
        "value": 0,
        "points": null
      },
      "investment": 0,
      "savings": 0,
      "co2_reduce": 0,
      "BENG2": "0",
      "gas_savings": 0,
      "electricity_savings": 0
    },
    "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
}

400: Bad Request Unsuccessful response

401: Unauthorized No access

422: Unprocessable Entity Wrong input format

500: Internal Server Error Service is not available and/or down

403: Forbidden Forbidden

301: Moved Permanently error

303: See Other house type error

Vraag een duurzaamheidsadvies op basis van BagID op. Nog te bepalen (TBD).