← API catalog

Vacation region resolver

$0.01 / call
GET /api/v1/nl/vacation-region

Resolve a Dutch place to its vacation region (noord/midden/zuid) and attach that region's current holiday dates.

Parameters

NameRequiredDescription
postcodenoDutch postcode, e.g. 1011AC (resolved to gemeente/region via PDOK). In the JSON request body.
plaatsnoPlace/city name.
gemeentenoMunicipality name.
provincenoProvince name.
samplenoQuery param on GET; set to 1 for the free demo response.

Free sample

curl https://api.agenticweb.nl/api/v1/nl/vacation-region?sample=1

Paid call

Returns 402 Payment Required; pay over x402 and retry.

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

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

CBS (CC BY 4.0) + Rijksoverheid (CC0).

Accepts postcode (resolved to gemeente via PDOK), plaats, gemeente or province. Resolves at province level with major-city/gemeente overrides; split provinces (Gelderland, Utrecht, Zuid-Holland) are flagged approximate.