lunterodevelopers
GuidesAPI Reference
Energy labels

Look up a Netherlands energy label

Look up a stored, verified Dutch energy label by exact address. Check the returned registration, retrieval date and validity where available.

GET
/v1/energy-labels

Reads verified registrations already held by Luntero. Does not trigger an upstream lookup or generation. No stored match returns 404; multiple matches return ambiguous_address. A missing record does not mean the dwelling has no registration. Check valid_until for expiry.

Authorization

ApiKey
headerAuthorizationBearer <lun_live_…>

Operator-issued API key. Keys are never accepted in query strings.

Query Parameters

locale?string

Select translated free-text fields. IDs, slugs, names of brands, enums and numeric values stay stable. Missing translations fall back to English.

Default"en"
Value in"en""nl""de""fr""es"
postcode*string
house_number*string
Match^[1-9]\d{0,4}$
addition?string
Match^[a-zA-Z0-9-]*$
Lengthlength <= 12

Response Body

Success. Monetary units are explicitly named; unknown values are null.

application/json
  1. response
data*
meta*
Example Request
curl -X GET 'https://api.luntero.com/v1/energy-labels?postcode=string&house_number=string'
Example Response
{  "data": {    "bag_object_id": "string",    "energy_label": "string",    "registered_at": "string",    "valid_until": "string",    "address": {      "street": "string",      "number": "string",      "postalCode": "string",      "displayAddress": "string"    },    "retrieved_at": "string"  },  "meta": {    "locale": "string",    "request_id": "string"  }}

Get recorded air quality measurements GET

Retrieve stored pollutant measurements by station or city over a date range. Responses include the component, measurement unit and timestamp.

Check Luntero API availability GET

Test connectivity to the Luntero API with a public HTTPS request. The ping endpoint needs no API key and returns the service name and status.