# Energielabel API

> Energielabel API is the Dutch energy label (energielabel) lookup service of [Nederland Postcode API](https://nederlandpostcode.nl). It returns current and historical energy label data for any Dutch address, together with the validated address (street, city) in every response.

Nederland Postcode API is a Dutch address and postcode API, used by developers, real estate platforms, and e-commerce integrations across the Netherlands to validate addresses and enrich them with location data. Energielabel API extends the same platform with RVO/EP-Online energy label data. EnergielabelAPI.nl documents these endpoints in detail; create an account and get API access at [nederlandpostcode.nl](https://nederlandpostcode.nl/registreren).

## Endpoints

- `GET https://api.nederlandpostcode.nl/v2/energy-label?postcode={postcode}&number={number}` — one address. Returns the validated address (street, city) plus the full `energy_labels` array: every registered label for that address, current and historical, with energy performance data (BENG1/BENG2/BENG3, CO₂ emission, construction year, and more). An existing address with no registered label returns `200` with an empty `energy_labels` array, not an error.
- `GET https://api.nederlandpostcode.nl/v1/energy-label-range?postcode={postcode}&number={number}&start_number={start}&end_number={end}` — a street or range of house numbers. Returns the validated address plus only the single most recent `energy_label` per address (no history). Addresses without a registered label are omitted from the response.

Both endpoints send the API token as a Bearer token in the `Authorization` header, using the same account and key as the rest of Nederland Postcode API.

Optional on both endpoints: `attributes[]=coordinates` adds a `coordinates` object (`latitude`, `longitude`) to each address. Omit the parameter and the field is left out of the response.

## Errors and limits

- `401` invalid or missing API token; `404` unknown endpoint; `422` invalid request; `429` rate limit or monthly quota exceeded.
- An address that exists but has no registered energy label is **not** an error: `/v2/energy-label` returns `200` with `"energy_labels": []`. Check for an empty array rather than a status code. (`/v1/energy-label-range` instead omits such addresses entirely.)
- A `422` is also returned when the postcode/number combination matches no address (`No address found for the given postcode and number.`) or more than one address (`Multiple addresses found for the given postcode and number.`). Pass an `addition` to disambiguate.
- Two independent limits apply per token: a per-subscription rate limit and a monthly credit quota. Both return `429` with a `quota` object naming the `strategy` that was hit. One request costs one credit, including requests that return no energy label.
- Full reference with example bodies: [Statuscodes en foutmeldingen](https://energielabelapi.nl/energielabel-api#statuscodes) and [Rate limits en quota](https://energielabelapi.nl/energielabel-api#limieten).

## Documentation

- [Energielabel API](https://energielabelapi.nl/energielabel-api): full field reference for both endpoints, with real example responses, status codes, rate limits, and an FAQ.
- [Historische energielabels](https://energielabelapi.nl/historische-energielabels): what the label history means and why a label can change over time.
- [API documentatie](https://nederlandpostcode.nl/documentatie): complete technical reference on nederlandpostcode.nl.

## Pricing

- [Tarieven](https://energielabelapi.nl/prijzen): plans start at €59,99/year (2.500 credits/month, 5 requests/second). The Energielabel API, Postcode API, and Wijken & Buurten API are included in every plan.

## About

- [Over ons](https://energielabelapi.nl/over-ons): about EnergielabelAPI.nl and Nederland Postcode API.
- [Privacybeleid](https://energielabelapi.nl/privacybeleid): privacy policy for this site.
- [nederlandpostcode.nl](https://nederlandpostcode.nl): the parent platform — create an account, manage billing, and use the full API.

## Data source

Energy label data is sourced from EP-Online, the official database of the Rijksdienst voor Ondernemend Nederland (RVO), and synced daily.