Energielabel API
Vraag officiële energielabelgegevens van elk Nederlands adres op: voor één adres, een hele straat of alle adressen in de buurt van een locatie.
Op EnergielabelAPI.nl vind je alles over onze Energielabel API: uitleg van ieder veld, voorbeeldresponses, historische energielabels en veelgestelde vragen.
Haal energielabels voor een adres op
Met de Energielabel API haal je snel en betrouwbaar energielabels op voor woningen en utiliteitsgebouwen in heel Nederland. De API verwerkt officiële energielabelgegevens van EP-Online, het register van de Rijksdienst voor Ondernemend Nederland (RVO), en combineert deze met ons postcode- en adresplatform. De energielabels worden dagelijks bijgewerkt op basis van mutaties die door RVO worden gepubliceerd.
Naast de labelklasse ontvang je uitgebreide energieprestatiegegevens, waaronder:
- EP1 - energiebehoefte (EP1), in kWh/m² per jaar
- EP2 - primair fossiel energiegebruik (EP2), in kWh/m² per jaar
- EP3 - aandeel hernieuwbare energie (EP3), in procenten
Elke response bevat daarnaast het gevalideerde adres (straat en woonplaats), zodat je direct kunt controleren of de opgegeven postcode en het huisnummer bij elkaar horen.
Drie endpoints
De Energielabel API bestaat uit drie endpoints. Welke je gebruikt, hangt af van of je één adres, een straat of alle adressen rond een locatie wilt opvragen.
| Kenmerk | /v2/energy-label |
/v1/energy-label-range |
/v1/energy-label-radius |
|---|---|---|---|
| Gebruik | Eén specifiek adres | Een hele straat of een reeks huisnummers | Alle adressen binnen een straal (max. 1000 meter) rond een coördinaat |
| Energielabels per adres | Actueel én historisch, in de energy_labels-array |
Alleen het meest recente label, als energy_label-object |
Alleen de labelklasse van het meest recente label, als tekst in energy_label |
| Adres zonder energielabel | 200 OK met een lege energy_labels-array |
Wordt weggelaten uit de response | Wordt weggelaten uit de response |
| Paginering | Nee | Ja, maximaal 25 adressen per pagina | Ja, maximaal 25 adressen per pagina |
| Coördinaten | attributes[]=coordinates |
attributes[]=coordinates |
Altijd, samen met de distance in meters |
| Ideaal voor | Woningpagina's, taxaties, hypotheekaanvragen en labelhistorie | Appartementencomplexen, VvE's, bouwblokken en verduurzamingsprojecten | Kaarten, buurtanalyses, vergelijkbare woningen en wijkgerichte verduurzamingscampagnes |
Energielabel van één adres
Met /v2/energy-label vraag je het energielabel van één specifiek adres op. Je krijgt niet alleen het actuele label terug, maar ook eventuele historische labels van hetzelfde pand, zodat je bijvoorbeeld kunt zien of een woning van label E naar B is gegaan.
GET https://api.nederlandpostcode.nl/v2/energy-label?postcode=1118BN&number=800
Energielabels van meerdere adressen
Met /v1/energy-label-range vraag je de energielabels van een hele straat of een specifiek deel van een straat in één keer op. Per adres krijg je het meest recente energielabel terug; adressen zonder geregistreerd label worden overgeslagen.
GET https://api.nederlandpostcode.nl/v1/energy-label-range?postcode=1118BN&number=800&start_number=700&end_number=900
Energielabels in de buurt
Met /v1/energy-label-radius vraag je de energielabels op van alle adressen binnen een straal van maximaal 1000 meter rond een coördinaat, gesorteerd op afstand. Per adres krijg je de coördinaten, de afstand in meters en de labelklasse van het meest recente energielabel terug. Zo toon je bijvoorbeeld alle energielabels in de buurt op een kaart.
GET https://api.nederlandpostcode.nl/v1/energy-label-radius?latitude=52.305285&longitude=4.750645&radius=150
Waarvoor gebruik je de Energielabel API?
- Makelaars en taxateurs - toon het energielabel en de energieprestaties direct bij een woning of taxatierapport
- Hypotheekverstrekkers en -adviseurs - bepaal op basis van het energielabel of een woning in aanmerking komt voor een groene hypotheek of extra leenruimte
- Vastgoedsoftware en woningplatforms - verrijk je objectgegevens automatisch met actuele en historische energielabels
- Verduurzamings- en installatiebedrijven - vind woningen met een laag energielabel en onderbouw adviezen met de energieprestatiegegevens
- VvE-beheerders - vraag in één request de energielabels van alle appartementen in een complex op
- Kaart- en buurtapplicaties - toon de energielabels van alle woningen rond een locatie op een kaart of vergelijk een woning met de buurt
Inbegrepen bij elk abonnement
De Energielabel API is inbegrepen bij elk Nederland Postcode API-abonnement. Je gebruikt dezelfde account en API-key als voor de andere endpoints.
Alle velden en voorbeelden
Een uitleg van ieder veld in de response, volledige voorbeeldresponses, statuscodes, rate limits en veelgestelde vragen vind je in de uitgebreide documentatie op EnergielabelAPI.nl.
Bekijk de Energielabel API-documentatie op EnergielabelAPI.nlLiever direct aan de slag? Alle parameters en voorbeeldrequests vind je ook in onze API documentatie.
Op de pagina Wat is mijn energielabel kun je het energielabel van jouw (toekomstige) woning opzoeken.