Authenticatie, invoer en resultaat

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

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

Headers

Naam	Type	Omschrijving
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
build_year	integer	Bouwjaar	1960
roof_type	integer	1 = (voornamelijk) schuin dak 2 = (voornamelijk) plat dak 3 = deels schuin, deels plat dak Als het platte of hellende deel meer dan 25% van het dakoppervlak beslaat, wordt type 3 gebruikt.	Standaard: 1
house_type	integer	1 = Vrijstaand 2 = 2 onder 1 kap 3 = Hoekwoning 4 = Tussenwoning	2
inner_surface_area	float	Woonoppervlakte (m²)	70
wall_insulation	integer	Bekijk Maatregelen	2
floor_insulation	integer	Bekijk Maatregelen	2
sloped_roof_insulation	integer	Bekijk Maatregelen	2
flat_roof_insulation	integer	Bekijk Maatregelen	2
living_room_windows	integer	Bekijk Maatregelen	2
bedroom_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
ev_charger	integer	Heeft het gebouw een laadpaal voor elektrische voertuigen? 0 = geen laadpaal 1 = laadpaal aanwezig	Standaard: 0
electricity_connection_type	integer	Het aansluitingstype van het gebouw 1 = 1-fase 2 = 3-fase	Standaard: 1
electricity_contract_type	integer	Type elektriciteitscontract 1 = vast contract 2 = dynamisch contract	Standaard: 1
dynamic_price_reference_year	integer	Het jaar vanaf wanneer dynamische prijzen worden gebruikt: 2023, 2024, 2025	Standaard: 2025
netting_enabled	integer	Of de salderingsregeling wordt toegepast. 0 = geen saldering 1 = saldering toegepast	Standaard: 1
solar_panels	list	Bekijk Maatregelen
number_of_solar_panels	integer	Bekijk Maatregelen
battery_type	integer	Bekijk Maatregelen
battery_system	integer	Bekijk Maatregelen

Request body

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

Response Status Codes

200: OK Successful response

{
  "Output": {
    "warnings": [],
    "postcode": "2771DS",
    "housenumber": 87,
    "houseaddition": null,
    "build_year": 1961,
    "inner_surface_area": 131,
    "house_type": "Vrijstaand",
    "installation": 6,
    "wall_insulation": 3,
    "sloped_roof_insulation": 1,
    "flat_roof_insulation": 1,
    "floor_insulation": 3,
    "living_room_windows": 2,
    "bedroom_windows": 2,
    "shower": 1,
    "ventilation": 4,
    "cooling": 1,
    "electric_cooking": 2,
    "solar_panels": {
      "pv_generation": 0,
      "curtailed_pv": 0,
      "self_consumed_pv": 0,
      "self_consumed_ratio": 0,
      "netting_enabled": 1
    },
    "battery": null,
    "CO2": 2299,
    "grid_import": 10436,
    "grid_feed": 0,
    "electricity_need": 10436,
    "definitive_energy_label": "A+++",
    "definitive_energy_label_type": "NTA 8800:2024 (basisopname woningbouw)",
    "definitive_energy_label_validity_date": "2036-1",
    "definitive_BENG2_score": 49,
    "current_estimated_energy_label": "A++",
    "current_estimated_BENG2_score": 75,
    "estimated_gas_usage": 0,
    "estimated_energy_usage": 10438,
    "estimated_city_heating_usage": 0,
    "measures_method": 1,
    "accuracy_indicator": 6,
    "response_meta": null
  }
}