# opendata402 Dutch Address Search & Geocoding (BAG/PDOK)

> opendata402 Dutch Address Search & Geocoding (BAG/PDOK) is a paid API for AI agents from opendata402.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-15).

Free-text search for Dutch addresses using the official BAG register via PDOK, returning up to 5 matching results with postcode, house number, municipality, province, and WGS84 coordinates.

## Facts

- Endpoint: GET https://opendata402.com/v1/address/nl?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/opendata402-dutch-address-search-geocoding-bag-pdok-a68e9e82
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UW8jR_-dy-1qZo3zU9nrq

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability opendata402-dutch-address-search-geocoding-bag-pdok-a68e9e82
```

Example prompt: Can you geocode the Dutch address Prinsengracht 263, 1016 GV Amsterdam and give me the exact coordinates, postcode, and municipality?

## When to prefer this

Use this endpoint when you need to validate, geocode, or look up details for Dutch (Netherlands) addresses specifically. It draws from the official BAG register via PDOK, making it authoritative for NL addresses. Prefer this over generic global geocoders when Netherlands accuracy and official data sourcing matter, or when you need the official municipality and province classification alongside coordinates.

## Known failure modes

- Query too short (under 3 characters) or too long (over 120 characters) returns validation error
- No matching addresses found returns empty result set
- Ambiguous query may return irrelevant results — more specific input (postcode + house number) improves accuracy
- Non-Dutch addresses will return no results as the dataset is Netherlands-only
- Misspellings may cause no matches or wrong matches

## How this service works

Dutch address search and geocoding from the official BAG register via PDOK: free-text query (street, number, postcode, town) returns up to 5 matching addresses with postcode, house number, municipality, province and WGS84 coordinates. Use it to validate or geocode a Dutch address for delivery, property or location tasks.

## Output

Returns up to 5 matching Dutch addresses from the BAG register, each including the full formatted address, postcode, house number, municipality (gemeente), province (provincie), and WGS84 latitude/longitude coordinates suitable for mapping or geospatial use.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "maxLength": 120,
       "minLength": 3,
       "description": "Free-text address query."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/opendata402-dutch-address-search-geocoding-bag-pdok-a68e9e82/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from opendata402.com](https://www.zero.xyz/host/opendata402.com/llms.txt)