Dutch building lookup (BAG)

$0.008 / call

GET /api/v1/nl/building

Construction year (bouwjaar), floor area (oppervlakte), use function (gebruiksdoel) and status for a Dutch address, from the BAG via PDOK.

Parameters

Name	Required	Description
`postcode`	yes	Dutch postcode, e.g. 1011AC.
`huisnummer`	yes	House number.
`sample`	no	Query param on GET; set to 1 for the free demo response.

Free sample

curl https://api.agenticweb.nl/api/v1/nl/building?sample=1

Paid call

Returns 402 Payment Required; pay over x402 and retry.

curl -X POST https://api.agenticweb.nl/api/v1/nl/building \
  -H 'Content-Type: application/json' \
  -d '{"postcode":"1011AC","huisnummer":128}'

This endpoint takes its parameters in a JSON request body rather than the query string, because they are personal data and a request URL is recorded in server access logs. A GET without ?sample=1 returns 405.

Licensing

Public Domain Mark 1.0 (BAG via PDOK); free for commercial reuse.

Building attributes are from the BAG verblijfsobject + pand. bouwjaar is null when the BAG carries an unknown sentinel; houseboats (ligplaats) and plots (standplaats) return the address with null building fields.