Authenticatie, invoer en resultaat

Bepaal het geschatte huidige of potentiële NTA 8800-energielabel.

POST https://api.altum.ai/v2/energylabel/apartments

Headers

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

Request Body

Veld	Type	Omschrijving	Voorbeeld/Standaard
postcode*	string	Zes-cijferige postcode	1234AB
housenumber*	integer	Huisnummer	1
houseaddition	string	Huisnummertoevoeging	A
position	integer	1 = hoekappartement op de begane grond 2 = tussenappartement op de begane grond 3 = hoekappartement op een tussenverdieping 4 = tussenappartement op een tussenverdieping 5 = hoekappartement op de bovenste verdieping 6 = tussenappartement op de bovenste verdieping 7 = volledige bovenste verdieping (penthouse)	Standaard: 1
floors	integer	Heeft de woning één of meerdere woonlagen? 1 = één woonlaag 2 = meerdere woonlagen	Standaard: 1
back_facade	boolean	Heeft de woning een achtergevel? false = nee true = ja	Standaard: false
build_year	integer	Bouwjaar	1960
inner_surface_area	float	Woonoppervlakte (m²)	70
apartment_type	integer	1 = 'Galerijflat' 2 = 'Portiekflat' 3 = 'Maisonnette' 4 = 'Benedenwoning' 5 = 'Bovenwoning' 6 = 'Portiekwoning'	2
wall_insulation	integer	Bekijk Maatregelen	2
floor_insulation	integer	Bekijk Maatregelen	2
roof_insulation	integer	Bekijk Maatregelen	2
living_room_windows	integer	Bekijk Maatregelen	2
installation	integer	Bekijk Maatregelen	Standaard: 4
shower	integer	Bekijk Maatregelen	Standaard: 1
cooling	integer	Is er een koelsysteem aanwezig? 1 = geen koeling 2 = airco-unit, directe luchtkoeling	Standaard: 1
ventilation	integer	Bekijk Maatregelen	1
electric_cooking	integer	Waar wordt mee gekookt? 1 = gasfornuis 2 = elektrisch fornuis	Standaard: 2 als installation gelijk is aan 6 of 7, anders 1.
inhabitants	integer	Aantal bewoners van de woning	Standaard: 3
solar_panels	list	Bekijk Maatregelen
number_of_solar_panels	integer	Bekijk Maatregelen

Voor optimale resultaten raden we aan om zowel de positie als het aantal woonlagen van het appartement mee te geven.

Verschillen ten opzichte van de Woningen-endpoint

• apartment_type in plaats van house_type

• roof_insulation in plaats van sloped_roof_insulation en flat_roof_insulation

• Geen bedroom_windows

• apartment_type is minder bepalend; de positie van het appartement en het aantal woonlagen zijn belangrijker.

Request body

{
  "postcode": "3024XL",
  "housenumber":227,
  "houseaddition": "B",
  "position": 3,
  "floors": 1
}

Response Status Codes

200: OK Successful response

{
  "Output": {
    "warnings": [],
    "tip": null,
    "postcode": "3024XL",
    "housenumber": 227,
    "houseaddition": "B",
    "build_year": 1927,
    "inner_surface_area": 74,
    "apartment_type": "Portiekwoning",
    "installation": 4,
    "wall_insulation": 1,
    "roof_insulation": null,
    "floor_insulation": null,
    "living_room_windows": 2,
    "shower": 1,
    "ventilation": 1,
    "cooling": 1,
    "electric_cooking": 1,
    "solar_panels": null,
    "CO2": 2208,
    "definitive_energy_label": null,
    "definitive_energy_label_type": null,
    "definitive_energy_label_validity_date": null,
    "definitive_BENG2_score": null,
    "current_estimated_energy_label": "C",
    "current_estimated_BENG2_score": 221,
    "estimated_gas_usage": 805,
    "estimated_energy_usage": 2262,
    "estimated_city_heating_usage": 0,
    "solar_panel_yield": 0,
    "measures_method": 2,
    "accuracy_indicator": 3,
    "response_meta": null
  }
}