Dutch address dossier

$0.025 / call

GET /api/v1/nl/dossier

One call, four registers for a Dutch address: the address itself, its BAG building (bouwjaar, floor area, use function), its AHN height above NAP, and CBS key figures for its gemeente.

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/dossier?sample=1

Paid call

Returns 402 Payment Required; pay over x402 and retry.

curl -X POST https://api.agenticweb.nl/api/v1/nl/dossier \
  -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

BAG/Kadaster + AHN/Rijkswaterstaat via PDOK (Public Domain Mark 1.0 / CC0); CBS key figures CC BY 4.0 — the CBS attribution must be kept downstream.

address and building are guaranteed on a 200; if either fails the whole call fails and nothing is charged. elevation and area degrade to a per-section status (no_data = the upstream holds nothing here, unavailable = it could not be reached). elevation is sampled at the resolved ADDRESS coordinate rather than the postcode centroid /nl/elevation uses, which is a trade-off: surface_m is then the height of THIS building (what a roof/solar question needs), but nap_m is usually null because the AHN masks buildings out of its terrain model — and object_height_m, being surface minus ground, is null with it. Call /nl/elevation with a bare postcode when you need ground level. area is CBS data for the whole gemeente, flagged scope: "gemeente" — context, not a property attribute. No inferred or scored fields.