De Energielabel API
Eén API voor actuele en historische energielabelgegevens van Nederlandse adressen. Op basis van een postcode en huisnummer, of van een locatie en een straal, krijg je het gevalideerde adres en de beschikbare energielabels terug, inclusief uitgebreide energieprestatiegegevens.
De onderliggende Postcode API is inbegrepen: elke response bevat automatisch het gevalideerde adres — straat en woonplaats — zodat je meteen kunt controleren of de opgegeven postcode en het huisnummer bij elkaar horen.
We halen de brondata dagelijks op bij RVO en verwerken en combineren dit in onze eigen database. Jouw requests komen dus rechtstreeks uit onze eigen infrastructuur, niet via een externe koppeling.
Account aanmakenWelke endpoint kies je?
Alle drie de endpoints geven energielabels van Nederlandse adressen terug, maar ze verschillen in waar je op zoekt, welke adressen je terugkrijgt en hoeveel labeldata er per adres in de response staat.
| Kenmerk | /v2/energy-label | /v1/energy-label-range | /v1/energy-label-radius |
|---|---|---|---|
| Je zoekt op |
postcode en
number
|
postcode en
number, plus
start_number en
end_number
|
latitude,
longitude en
radius in meters
|
| Welke adressen | Precies één adres | Adressen in dezelfde straat, binnen de reeks huisnummers | Adressen binnen de straal, ongeacht straat of postcode |
| Energielabel |
Alle labels, inclusief historie, in de
energy_labels-array
|
Alleen het meest recente label, als
energy_label-object met alle velden
|
Alleen de meest recente labelklasse, als tekst in
energy_label
(bijvoorbeeld "C")
|
| Adres zonder label |
Wel in de response, met een lege
energy_labels-array
|
Weggelaten uit de response | Weggelaten uit de response |
| Coördinaten |
Optioneel via
attributes[]=coordinates
|
Optioneel via
attributes[]=coordinates
|
Altijd, plus de afstand tot het opgegeven punt in
distance
|
| Paginering | Nee, je krijgt één adres terug |
Ja, per_page
standaard 10, maximaal 25
|
Ja, per_page
standaard 10, maximaal 25
|
Range of radius?
De namen lijken op elkaar, maar de endpoints zoeken op een heel andere manier.
Bij energy-label-range
begin je bij een adres en vraag je een
reeks huisnummers in dezelfde straat op — handig voor een appartementencomplex of VvE.
Bij energy-label-radius
begin je bij een punt op de kaart en
krijg je de adressen binnen een straal van maximaal 1.000 meter, ook in andere straten
en postcodes — handig voor een buurtanalyse of een kaartweergave. Beide endpoints geven
alleen adressen terug waarvoor een energielabel is geregistreerd.
Energielabel van één adres
Vraag het energielabel van één specifiek adres op. Naast het gevalideerde adres krijg je
de volledige energy_labels-array
terug: niet alleen het actuele label, maar ook eventuele historische labels van hetzelfde
pand.
GET https://api.nederlandpostcode.nl/v2/energy-label?postcode=1118BN&number=800
Stuur je API-key mee in de
Authorization: Bearer-header.
postcode en
number zijn verplicht,
addition en
attributes[] zijn optioneel.
Energielabels van meerdere adressen
Wil je de energielabels van meerdere adressen opvragen? Met de
energy-label-range-endpoint
kun je de beschikbare energielabels van een hele straat of een specifiek deel van een
straat in één keer opvragen. Dit is bijvoorbeeld handig voor een appartementencomplex,
VvE of een reeks huisnummers binnen dezelfde straat.
Deze endpoint geeft per adres alleen het meest
recente energielabel terug — als energy_label
(enkelvoud), zonder historie. Wil je de volledige labelhistorie van een adres, gebruik dan
/v2/energy-label. Ook belangrijk:
je krijgt alleen adressen terug waarvoor minimaal één energielabel beschikbaar is — een
huisnummer zonder geregistreerd label komt niet in de response voor.
Zoek je niet op huisnummers binnen een straat, maar op afstand rond een locatie? Gebruik dan /v1/energy-label-radius.
GET https://api.nederlandpostcode.nl/v1/energy-label-range?postcode=1118BN&number=800&start_number=700&end_number=900
Stuur je API-key mee in de
Authorization: Bearer-header.
postcode en
number zijn verplicht,
start_number en
end_number begrenzen de
huisnummers die worden meegenomen.
attributes[] is optioneel.
Energielabels binnen een straal
Met de energy-label-radius-endpoint
vraag je de energielabels op van alle adressen binnen een straal rond een punt op de kaart.
Je geeft een breedte- en lengtegraad en een straal in meters op, en krijgt de adressen
binnen die cirkel terug — ongeacht in welke straat of postcode ze liggen. Handig voor een
buurtanalyse, een kaartweergave of om woningen rond een project te vinden.
Per adres krijg je alleen de meest recente
labelklasse terug, als tekst in
energy_label — bijvoorbeeld
"C". Let op: bij
/v1/energy-label-range bevat
hetzelfde veld een object met alle labelgegevens. Net als bij de range-endpoint krijg je
alleen adressen terug waarvoor een energielabel is geregistreerd. Heb je de volledige
labelgegevens of de historie van een adres nodig, vraag die dan op via
/v2/energy-label.
GET https://api.nederlandpostcode.nl/v1/energy-label-radius?latitude=52.30528553688755&longitude=4.750645160863609&radius=150
Stuur je API-key mee in de
Authorization: Bearer-header.
latitude (tussen -90 en 90),
longitude (tussen -180 en 180) en
radius (een geheel aantal meters,
van 1 tot en met 1.000) zijn verplicht.
per_page (standaard 10, maximaal 25) en
page zijn optioneel. Er is geen
attributes[]-parameter: de
coördinaten zitten altijd in de response.
Gesorteerd op afstand
distance is de afstand
in hele meters tussen het opgegeven punt en het adres. De resultaten staan op volgorde
van afstand, het dichtstbijzijnde adres eerst. Bij gelijke afstand wordt gesorteerd op
postcode, huisnummer en toevoeging.
Geen energielabels in de buurt
Liggen er binnen de straal geen adressen met een geregistreerd energielabel, dan is
dat geen fout: je krijgt een
200 met een lege
data-array. Vergroot
eventueel de straal, tot maximaal 1.000 meter.
Coördinaten opvragen
Heb je naast het energielabel ook de locatie van het adres nodig? Stuur dan
attributes[]=coordinates
mee. /v2/energy-label en
/v1/energy-label-range geven
dan een extra
coordinates-object terug met de
breedte- en lengtegraad van het adres. Stuur je de parameter niet mee, dan blijft het veld
weg uit de response.
Bij /v1/energy-label-radius hoef je niets mee te sturen: daar zitten de coördinaten altijd in de response.
GET https://api.nederlandpostcode.nl/v2/energy-label?postcode=1118BN&number=800&attributes[]=coordinates
Uitleg van de velden
Hieronder staat elk veld dat een response kan bevatten, met de betekenis ervan. De
adresvelden zijn gelijk voor alle endpoints. De labelgegevens en gebouw- en
energieprestatiegegevens zitten per registratie in
energy_labels (bij
/v2/energy-label) of in het
energy_label-object (bij
/v1/energy-label-range).
/v1/energy-label-radius geeft
alleen de labelklasse terug.
Adresgegevens
| postcode | De Nederlandse postcode van het adres. |
| number | Het huisnummer van het adres. |
| addition | De eventuele huisnummertoevoeging. |
| street | De straatnaam van het adres. |
| city | De woonplaats van het adres. |
| coordinates |
De latitude en
longitude van het adres.
Alleen aanwezig als je
attributes[]=coordinates
meestuurt — zie Coördinaten opvragen. Bij
/v1/energy-label-radius
altijd aanwezig.
|
| distance |
De afstand in hele meters tussen het opgegeven punt en het adres. Alleen
aanwezig bij
/v1/energy-label-radius.
|
Labelgegevens
| registration_date | Datum waarop het energielabel in EP-Online is geregistreerd. |
| inspection_date | Datum waarop de opname van het gebouw heeft plaatsgevonden. |
| valid_until_date | Datum tot wanneer het energielabel geldig is. |
| status |
De status van het gebouw of de registratie, bijvoorbeeld
bestaand of
oplevering.
|
| construction_type | Geeft aan of het om woningbouw of utiliteitsbouw gaat. |
| building_type | Het specifieke type gebouw of woning, indien beschikbaar. |
| energy_label |
De geregistreerde energielabelklasse. Bij
/v1/energy-label-radius
staat deze waarde direct in
energy_label op het
adres.
G
F
E
D
C
B
A
A+
A++
A+++
A++++
A+++++
|
| calculation_type | De rekenmethodiek waarmee het energielabel is bepaald. |
| inspection_type | Het type opname dat is uitgevoerd, bijvoorbeeld een basis- of detailopname. |
| construction_year | Het bouwjaar van het gebouw. |
Gebouw- en energieprestatiegegevens
| thermal_zone_area | De oppervlakte van de thermische zone, uitgedrukt in m². |
| compactness | De compactheid van het gebouw: de verhouding tussen het verliesoppervlak en de gebruiksoppervlakte. |
| energy_demand | De berekende energiebehoefte van het gebouw per m² per jaar (BENG1). |
| energy_demand_requirement | De bijbehorende BENG1-eis, wanneer deze van toepassing is. |
| primary_fossil_energy | Het berekende primaire fossiele energiegebruik per m² per jaar (BENG2). |
| primary_fossil_energy_requirement | De bijbehorende BENG2-eis, wanneer deze van toepassing is. |
| primary_fossil_energy_emg | De EMG-waarde voor primair fossiel energiegebruik, wanneer beschikbaar. |
| renewable_energy_share | Het aandeel hernieuwbare energie, uitgedrukt als percentage (BENG3). |
| renewable_energy_share_requirement | De bijbehorende BENG3-eis voor het aandeel hernieuwbare energie, wanneer van toepassing. |
| renewable_energy_share_emg | Het EMG-berekende aandeel hernieuwbare energie, wanneer beschikbaar. |
| calculated_energy_consumption | Het berekende energiegebruik van het gebouw volgens de betreffende rekenmethodiek. |
| heat_demand | De berekende warmtevraag van het gebouw. |
| calculated_co2_emission | De berekende CO₂-uitstoot. |
| temperature_excess | De berekende temperatuuroverschrijding. |
| temperature_excess_requirement | De bijbehorende eis voor temperatuuroverschrijding, wanneer van toepassing. |
Actueel én historisch
De energy_labels-array
bevat alle beschikbare energielabelregistraties van het adres. Je krijgt dus niet
alleen het meest recente label terug, maar ook eerdere registraties wanneer deze
beschikbaar zijn — bijvoorbeeld om te zien of een woning van label E naar C of B is
gegaan. Er is geen apart historie-endpoint nodig.
Consistente velden, soms een lege waarde
Elke registratie bevat dezelfde velden. Ontbrekende of niet-toepasselijke waarden —
bijvoorbeeld een BENG-eis die niet gebruikt is — worden als
null teruggegeven in
plaats van het veld weg te laten.
Statuscodes en foutmeldingen
Alle endpoints geven standaard HTTP-statuscodes terug. Bij een fout bevat de response
altijd een message-veld
met een omschrijving van wat er misging.
| 200 | De aanvraag is succesvol verwerkt. |
| 401 | Niet geautoriseerd: je API-key ontbreekt of is ongeldig. |
| 403 | Je gebruikt een test-API-key met een postcode die niet in de lijst met test-postcodes staat. |
| 404 | De opgevraagde API-endpoint bestaat niet. Controleer de URL en de versie. |
| 422 | De aanvraag kon niet verwerkt worden. Controleer de meegestuurde parameters — zie de voorbeelden hieronder. |
| 429 | Te veel aanvragen: je rate limit of je maandelijkse quota is bereikt. |
Adres zonder energielabel
Bestaat het adres wel, maar is er geen energielabel voor geregistreerd? Dan is dat
geen fout: je krijgt een gewone
200 met de adresvelden
zoals gebruikelijk gevuld, en een lege
energy_labels-array. Controleer
dus op een lege array in plaats van op een foutcode.
Let op: de andere endpoints werken hier anders. Bij
/v1/energy-label-range en
/v1/energy-label-radius worden adressen
zonder geregistreerd energielabel helemaal weggelaten uit de response.
Geen of meerdere adressen gevonden
Vraag je een energielabel op voor een adres dat niet bestaat, of levert de combinatie van
postcode en huisnummer meerdere adressen op, dan krijg je een
422 Unprocessable Content
terug. Bij meerdere treffers los je dit op door ook een
addition mee te sturen.
Geen adres gevonden
Meerdere adressen gevonden
Bij /v1/energy-label-radius zoek je niet
op een adres, dus daar krijg je deze foutmeldingen niet. Liggen er geen adressen met een
energielabel binnen de straal, dan krijg je een 200 met een
lege data-array.
Ontbrekende of ongeldige parameters
Ontbreekt een verplichte parameter of heeft die de verkeerde vorm, dan krijg je eveneens
een 422, met per veld de
reden in een errors-object.
Dat geldt ook voor een radius
groter dan 1.000 meter of een
per_page groter dan 25.
Rate limits en quota
Op je API-key gelden twee onafhankelijke limieten: een rate limit die bepaalt hoeveel
aanvragen je kort achter elkaar mag doen, en een maandelijkse quota die het totale aantal
credits bepaalt. Beide leveren bij overschrijding een
429 op, met een
quota-object dat aangeeft
welke limiet je hebt geraakt.
Rate limit
Hoeveel aanvragen per seconde je mag doen, hangt af van je abonnement. De limiet per abonnement staat op de tarievenpagina. Elke aanvraag telt als één credit — ook een aanvraag die geen energielabel oplevert.
Maandelijkse quota
Je verbruik reset elke maand. Via het
/quota-endpoint
zie je hoeveel credits je al hebt gebruikt. Houd er rekening mee dat verbruik tot
vijf minuten kan achterlopen.
Rate limit overschreden
Maandelijkse quota overschreden
De waarden bij limit zijn
voorbeelden. Welke limiet voor jouw API-key geldt, hangt af van je abonnement en zie je in
je accountdashboard.
Veelgestelde vragen
Welke gegevens geeft de Energielabel API terug?
Je krijgt het gevalideerde adres (straat en woonplaats) en alle energielabels die voor dat adres in EP-Online geregistreerd staan. Per label krijg je onder meer de labelklasse, de registratie-, opname- en geldigheidsdatum, de rekenmethodiek, het bouwjaar en uitgebreide energieprestatiegegevens zoals de energiebehoefte, het primair fossiel energiegebruik, het aandeel hernieuwbare energie en de CO2-uitstoot.
Krijg ik ook historische energielabels?
Ja. Het /v2/energy-label-endpoint geeft alle geregistreerde labels van een adres terug in de energy_labels-array, dus naast het actuele label ook eerdere registraties. Er is geen apart historie-endpoint nodig. De /v1/energy-label-range- en /v1/energy-label-radius-endpoints geven per adres alleen het meest recente label.
Kan ik meerdere adressen in één keer opvragen?
Ja, op twee manieren. Met het /v1/energy-label-range-endpoint vraag je de energielabels van een hele straat of een reeks huisnummers in één aanvraag op; adressen zonder geregistreerd energielabel worden dan niet in de response opgenomen. Met het /v1/energy-label-radius-endpoint vraag je de adressen binnen een straal van maximaal 1.000 meter rond een locatie op. Bij beide endpoints worden adressen zonder geregistreerd energielabel niet in de response opgenomen.
Wat is het verschil tussen energy-label-range en energy-label-radius?
Bij energy-label-range begin je bij een adres (postcode en huisnummer) en krijg je de adressen binnen een reeks huisnummers in dezelfde straat, met per adres het volledige meest recente label. Bij energy-label-radius begin je bij coördinaten en krijg je de adressen binnen een straal in meters, ongeacht straat of postcode, gesorteerd op afstand. Per adres staat daar alleen de labelklasse als tekst in energy_label. Beide endpoints geven alleen adressen terug waarvoor een energielabel is geregistreerd.
Kan ik energielabels in de buurt van een locatie opvragen?
Ja. Stuur een latitude, longitude en radius (1 tot en met 1.000 meter) naar het /v1/energy-label-radius-endpoint. Je krijgt de adressen met een energielabel binnen die straal terug, met de coördinaten, de afstand in meters tot het opgegeven punt en de meest recente labelklasse. Liggen er geen adressen met een energielabel binnen de straal, dan krijg je een 200 met een lege data-array.
Waar komen de energielabelgegevens vandaan?
Uit EP-Online, de officiële database met geregistreerde energielabels van de Rijksdienst voor Ondernemend Nederland (RVO). We halen de brondata dagelijks op en verwerken die in onze eigen database, zodat aanvragen rechtstreeks uit onze eigen infrastructuur komen.
Heb ik een apart abonnement nodig voor de Energielabel API?
Nee. De Energielabel API is inbegrepen bij elk Nederland Postcode API-abonnement en staat standaard aan. Je gebruikt dezelfde API-key als voor de andere endpoints; er is geen aparte activatie nodig.
Hoeveel credits kost een aanvraag?
Eén API-request kost één credit. Dat geldt ook voor een aanvraag die geen energielabel oplevert. Hoeveel credits je per maand hebt, hangt af van je abonnement.
Zit adresvalidatie bij de Energielabel API inbegrepen?
Ja. Elke response bevat automatisch het gevalideerde adres uit dezelfde adressendatabase als Nederland Postcode API, zodat je in dezelfde aanvraag kunt controleren of de opgegeven postcode en het huisnummer bij elkaar horen. Daar zijn geen aparte koppeling en geen extra kosten voor nodig.
Kan ik ook de coördinaten van een adres opvragen?
Ja. Stuur attributes[]=coordinates mee met je aanvraag, dan bevat de response een extra coordinates-object met de latitude en longitude van het adres. Stuur je die parameter niet mee, dan blijft het veld weg uit de response. Bij het /v1/energy-label-radius-endpoint zitten de coördinaten altijd in de response.
Wat krijg ik terug als een adres geen energielabel heeft?
Dan krijg je gewoon een 200 terug met het gevalideerde adres en een lege energy_labels-array. Een adres zonder geregistreerd energielabel is geen foutsituatie, dus controleer op een lege array in plaats van op een foutcode. Bij de /v1/energy-label-range- en /v1/energy-label-radius-endpoints werkt dit anders: daar worden adressen zonder energielabel helemaal weggelaten uit de response.
Wat gebeurt er als een adres niet bestaat?
Dan krijg je een 422 Unprocessable Content terug met de melding dat er geen adres is gevonden. Levert de combinatie van postcode en huisnummer meerdere adressen op, dan krijg je eveneens een 422; stuur in dat geval ook een addition mee om het juiste adres te kiezen.
API-documentatie →
Bekijk alle parameters, responsevelden en technische details van de API.
Historische energielabels →
Lees meer over de labelhistorie van een adres en hoe je deze kunt gebruiken.