Energielabel API V2: uitgebreide energiegegevens
De Energielabel API is vernieuwd. Met versie V2 krijg je naast het energielabel toegang tot veel meer energieprestatiegegevens van Nederlandse gebouwen.
Goed nieuws voor ontwikkelaars, vastgoedprofessionals en data-analisten: de Energielabel API V2 is beschikbaar. Met deze nieuwe versie kun je officiële energielabelgegevens van Nederlandse woningen en utiliteitsgebouwen opvragen, inclusief uitgebreide informatie over de energieprestatie van het gebouw.
De gegevens zijn afkomstig van EP-Online, het register van de Rijksdienst voor Ondernemend Nederland (RVO), en worden via Nederland Postcode API gekoppeld aan het juiste adres. Zo kun je energiegegevens eenvoudig gebruiken in je eigen applicatie, website of analyse.
Wat is er nieuw in V2?
V2 bevat aanzienlijk meer informatie dan de vorige versie van de Energielabel API. Naast het energielabel en de geldigheidsdatum krijg je bijvoorbeeld ook de registratiedatum, status, gebruikte rekenmethode, het bouwjaar en verschillende energieprestatie-indicatoren.
Ook zijn de veldnamen duidelijker gemaakt en sluiten ze beter aan op de gegevens die vanuit EP-Online beschikbaar zijn. Hierdoor kun je de verschillende waarden beter gebruiken voor analyses en verdere verwerking.
Energielabel opvragen
Een energielabel vraag je op met de postcode en het huisnummer.
Gebruik hiervoor het nieuwe /v2/energy-label endpoint:
GET https://api.nederlandpostcode.nl/v2/energy-label?postcode=1118BN&number=800
Wanneer een postcode en huisnummer bij meerdere adressen horen, kun je met
addition het juiste adres selecteren.
Voorbeeld response
De V2-response bevat het adres en een lijst met de beschikbare energielabels. Dit kunnen zowel actuele als historische energielabels zijn.
{
"data": {
"postcode": "1118BN",
"number": 800,
"addition": null,
"street": "Schiphol Boulevard",
"city": "Schiphol",
"energy_labels": [
{
"registration_date": "30-08-2022",
"inspection_date": "02-08-2022",
"valid_until_date": "02-08-2032",
"status": "bestaand",
"construction_type": "utiliteitsbouw",
"building_type": null,
"energy_label": "A+++",
"calculation_type": "NTA 8800:2022 (basisopname utiliteitsbouw)",
"inspection_type": "basis",
"construction_year": 2019,
"thermal_zone_area": 5648.39,
"compactness": 1.16,
"energy_demand": 98.4,
"energy_demand_requirement": null,
"primary_fossil_energy": 55.48,
"primary_fossil_energy_requirement": null,
"primary_fossil_energy_emg": null,
"renewable_energy_share": 55.3,
"renewable_energy_share_requirement": null,
"renewable_energy_share_emg": null,
"calculated_energy_consumption": 55.48,
"heat_demand": 55.02,
"calculated_co2_emission": 13.01,
"temperature_excess": 0,
"temperature_excess_requirement": null
}
]
}
}Welke gegevens krijg je?
Met V2 krijg je naast de gegevens van het adres de volgende informatie per energielabel:
| Veld | Omschrijving |
|---|---|
registration_date |
Registratiedatum van het energielabel (dd-mm-jjjj) |
inspection_date |
Opnamedatum van het energielabel (dd-mm-jjjj) |
valid_until_date |
Geldigheidsdatum van het energielabel (dd-mm-jjjj) |
status |
Status van het energielabel, zoals vergunningsaanvraag, oplevering of bestaand |
construction_type |
Type bouw (woningbouw of utiliteitsbouw) |
building_type |
Type gebouw, indien beschikbaar |
energy_label |
Energielabel (G t/m A+++++) |
calculation_type |
Gebruikte rekenmethode voor het energielabel |
inspection_type |
Type opname, zoals basis of detail |
construction_year |
Bouwjaar van het gebouw |
thermal_zone_area |
Oppervlakte van de thermische zone in m² |
compactness |
Compactheid van het gebouw |
energy_demand |
Energiebehoefte |
energy_demand_requirement |
Eis voor de energiebehoefte |
primary_fossil_energy |
Primair fossiel energiegebruik |
primary_fossil_energy_requirement |
Eis voor primair fossiel energiegebruik |
primary_fossil_energy_emg |
Primair fossiel energiegebruik volgens EMG |
renewable_energy_share |
Aandeel hernieuwbare energie in procenten |
renewable_energy_share_requirement |
Eis voor het aandeel hernieuwbare energie |
renewable_energy_share_emg |
Aandeel hernieuwbare energie volgens EMG |
calculated_energy_consumption |
Berekend energiegebruik |
heat_demand |
Warmtebehoefte |
calculated_co2_emission |
Berekende CO₂-uitstoot |
temperature_excess |
Temperatuuroverschrijding |
temperature_excess_requirement |
Eis voor temperatuuroverschrijding |
Niet alle energieprestatiegegevens zijn voor ieder energielabel beschikbaar.
Wanneer een waarde niet van toepassing is of niet beschikbaar is, wordt null teruggegeven.
Actuele en historische energielabels
De API kan meerdere energielabels voor hetzelfde adres teruggeven. Hierdoor kun je niet alleen het huidige energielabel bekijken, maar ook zien hoe het energielabel van een gebouw in de loop van de tijd is veranderd.
Ieder energielabel bevat een eigen opname- en geldigheidsdatum.
De registration_date geeft aan wanneer het energielabel in het register is opgenomen.
Voor wie is V2 geschikt?
De Energielabel API V2 is ideaal voor:
- Vastgoedplatforms - toon energielabels en energieprestatiegegevens direct bij woningen en bedrijfspanden
- Makelaars en taxateurs - voeg officiële energiegegevens toe aan vastgoedsoftware en workflows
- Vastgoedbeheerders - gebruik energiegegevens voor beheer, verduurzaming en rapportages
- Data-analisten - combineer energieprestatiegegevens met andere datasets voor analyses
- Ontwikkelaars - integreer energielabels eenvoudig in je eigen applicatie of website
Van V1 naar V2
V2 is de aanbevolen versie voor nieuwe integraties.
Het endpoint is gewijzigd naar /v2/energy-label en de response bevat uitgebreidere en duidelijker benoemde gegevens.
Gebruik je momenteel V1? Dan kun je deze blijven gebruiken voor bestaande integraties. Voor nieuwe toepassingen raden we aan om direct V2 te gebruiken.
Meer informatie, alle beschikbare velden en voorbeelden vind je in de API documentatie.