Energielabel API voor Nederland via EP-Online — haal het officiële energielabel op voor elk adres. EP-Online API integratie via PDOK en BAG.

GET /v1/real-estate/energy-label

Looks up the official EP-Online energy label for a Dutch address using a two-step pipeline:

PDOK Locatieserver resolves the postcode + house number to a BAG adresseerbaarobject_id
EP-Online v5 returns the energy label registration for that BAG object

The energy label is the official certificate issued by a certified energy advisor and registered with RVO (Rijksdienst voor Ondernemend Nederland).

Request parameters

Parameter	Type	Required	Description
`postcode`	string	✓	Dutch postcode, e.g. `1012LG` or `1012 LG`
`house_number`	string	✓	House number (may include addition, e.g. `42A`)

Example request

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.omnizoek.nl/v1/real-estate/energy-label?postcode=1012LG&house_number=1"

Example response

{
  "bag_id": "0363010000000001",
  "postcode": "1012LG",
  "house_number": "1",
  "energy_label": "A",
  "label_class": "A+",
  "calculation_type": "Woningcertificaat",
  "registered_at": "2023-06-14",
  "valid_until": "2033-06-14"
}

Response fields

Field	Type	Description
`bag_id`	string	BAG `adresseerbaarobject_id`
`postcode`	string	Postcode (normalised, no space)
`house_number`	string	House number as resolved by BAG
`energy_label`	string	Label letter (`A` – `G`)
`label_class`	string	Detailed class if applicable (`A+`, `A++`, etc.)
`calculation_type`	string	Certificate type (e.g. `Woningcertificaat`, `Maatwerkcertificaat`)
`registered_at`	string	ISO 8601 registration date
`valid_until`	string	ISO 8601 expiry date (typically 10 years after registration)

Data flow

Client
  │
  ▼
PDOK Locatieserver  ──►  BAG adresseerbaarobject_id
  │
  ▼
EP-Online v5        ──►  energy label registration

Error responses

Status	Cause
`404`	Address not found in BAG
`404`	Address found in BAG but no energy label registered
`503`	EP-Online or PDOK is unreachable

Caching

BAG ID lookups are cached for 24 hours. Energy label results are cached per bag_id for 12 hours.

Notes

Energy labels are mandatory for residential properties in the Netherlands since 2015. Older properties may not have a label yet, resulting in a 404.
Commercial properties are supported when an EP-Online registration exists.
The valid_until field reflects the 10-year validity of the certificate as defined by the Besluit energieprestatie gebouwen.

Energielabel (EP-Online)