Energy label API
Request official energy label data for any Dutch address: for a single address, an entire street or all addresses near a location.
Energielabel API
part of Nederland Postcode API
EnergielabelAPI.nl covers everything about our Energy label API: an explanation of every field, example responses, historical energy labels and frequently asked questions (in Dutch).
Retrieve energy labels for an address
With the Energy label API you can quickly and reliably retrieve energy labels for residential and non-residential buildings throughout the Netherlands. The API processes official energy label data from EP-Online, the register of the Netherlands Enterprise Agency (RVO), and combines it with our postcode and address platform. Energy labels are updated daily using mutations published by RVO.
Besides the label class, you receive detailed energy performance data, including:
- EP1 - energy demand (EP1), in kWh/m² per year
- EP2 - primary fossil energy (EP2), in kWh/m² per year
- EP3 - renewable energy share (EP3), as a percentage
Every response also includes the validated address (street and city), so you can immediately check whether the given postcode and house number belong together.
Three endpoints
The Energy label API consists of three endpoints. Which one you use depends on whether you want to retrieve one address, a street or all addresses around a location.
| Property | /v2/energy-label |
/v1/energy-label-range |
/v1/energy-label-radius |
|---|---|---|---|
| Use | One specific address | An entire street or a range of house numbers | All addresses within a radius (max. 1000 meters) around a coordinate |
| Energy labels per address | Current and historical, in the energy_labels array |
Only the most recent label, as an energy_label object |
Only the label class of the most recent label, as a string in energy_label |
| Address without an energy label | 200 OK with an empty energy_labels array |
Left out of the response | Left out of the response |
| Pagination | No | Yes, up to 25 addresses per page | Yes, up to 25 addresses per page |
| Coordinates | attributes[]=coordinates |
attributes[]=coordinates |
Always, together with the distance in meters |
| Ideal for | Property pages, valuations, mortgage applications and label history | Apartment complexes, homeowners' associations (VvE), housing blocks and sustainability projects | Maps, neighborhood analyses, comparable homes and area-based sustainability campaigns |
Energy label of one address
With /v2/energy-label you retrieve the energy label of one specific address. You receive not only the current label, but also any historical labels of the same building, so you can see, for example, whether a home went from label E to B.
GET https://api.nederlandpostcode.nl/v2/energy-label?postcode=1118BN&number=800Energy labels of multiple addresses
With /v1/energy-label-range you retrieve the energy labels of an entire street or a specific part of a street at once. For each address you receive the most recent energy label; addresses without a registered label are skipped.
GET https://api.nederlandpostcode.nl/v1/energy-label-range?postcode=1118BN&number=800&start_number=700&end_number=900Energy labels nearby
With /v1/energy-label-radius you retrieve the energy labels of all addresses within a radius of up to 1000 meters around a coordinate, sorted by distance. For each address you receive the coordinates, the distance in meters and the label class of the most recent energy label. This lets you, for example, show all energy labels in a neighborhood on a map.
GET https://api.nederlandpostcode.nl/v1/energy-label-radius?latitude=52.305285&longitude=4.750645&radius=150What can you use the Energy label API for?
- Real estate agents and appraisers - show the energy label and energy performance directly with a property listing or valuation report
- Mortgage lenders and advisors - determine based on the energy label whether a home qualifies for a green mortgage or additional borrowing capacity
- Property software and listing platforms - automatically enrich your property data with current and historical energy labels
- Sustainability and installation companies - find homes with a low energy label and support your advice with energy performance data
- Homeowners' association (VvE) managers - retrieve the energy labels of all apartments in a complex in a single request
- Map and neighborhood applications - show the energy labels of all homes around a location on a map or compare a home with its neighborhood
Included in every subscription
The Energy label API is included in every Nederland Postcode API subscription. You use the same account and API key as for the other endpoints.
All fields and examples
An explanation of every field in the response, complete example responses, status codes, rate limits and frequently asked questions can be found in the extensive documentation on EnergielabelAPI.nl (in Dutch).
View the Energy label API documentation on EnergielabelAPI.nlWant to get started right away? All parameters and example requests can also be found in our API documentation.
On the page What is my energy label you can look up the energy label of your (future) home.