# Dutch Address Lookup BAG PDOK

> Dutch Address Lookup BAG PDOK is a paid API for AI agents from api.boscolabs.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-11).

Validates and geocodes Dutch addresses and postcodes using official Kadaster BAG data via PDOK, returning coordinates, building details, and standardized address information.

## Facts

- Endpoint: POST https://api.boscolabs.dev/v1/dutch-address-lookup?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/dutch-address-lookup-bag-pdok-38f1b660
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DLb3nth1PxzbyU1FInvO3

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 dutch-address-lookup-bag-pdok-38f1b660 -d '<json body>'
```

Example prompt: Can you validate this Dutch address and give me its official BAG data, coordinates, and construction year — Prinsengracht 263, 1016 GV Amsterdam?

## When to prefer this

Use this endpoint when you need authoritative, government-sourced Dutch address validation and geocoding from the official Kadaster BAG register. Prefer over generic geocoders when you need BAG IDs, construction year, building use, floor area, or RD (Rijksdriehoek) coordinates specific to the Netherlands. Ideal for compliance, logistics, property tech, or any workflow requiring verified Dutch address data with an official source citation per row.

## Known failure modes

- Address not found in BAG — returns empty result, no charge
- Invalid postcode format — rejected by input validation
- BAG ID does not match 16-digit nummeraanduiding pattern — validation error
- House number not present at given postcode — empty result
- Exceeds 50-item batch limit — request rejected
- Ambiguous address string with multiple matches — may return multiple candidates or best match

## How this service works

Dutch address lookup and BAG geocoding: validate Dutch addresses, postcodes and BAG ids, get the official address, coordinates (WGS84, RD) and building data: construction year, use, floor area. Kadaster BAG via PDOK. Typical call $0.005: $0.002 per address resolved, min $0.005. upto: pay only for delivered rows; exact: pays the quote. Nothing is settled on an error or empty result. By Bosco Labs: official sources, source link per row.

## Output

For each resolved address: standardized official address fields (street, house number, postcode, city), WGS84 and RD New coordinates, BAG nummeraanduiding ID, building data (construction year, use type, floor area), and a source link to the official PDOK/BAG record. Empty or error results are not charged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "bagIds": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^\\D*(\\d\\D*){16}$"
   },
   "maxItems": 50,
   "description": "16-digit BAG identifiers: nummeraanduiding"
  },
  "include": {
   "type": "array",
   "items": {
    "enum": [
     "address",
     "building",
     "coordinates"
    ],
    "type": "string"
   },
   "default": [
    "address",
    "building",
    "coordinates"
   ],
   "description": "Which sections to fill: any of \"address\""
  },
  "postcode": {
   "type": "string",
   "pattern": "^(\\s*[1-9]\\d{3}\\s?[A-Za-z]{2}\\s*)?$",
   "description": "A Dutch postcode, 4 digits + 2 letters, e.g. \"1012JS\" or \"1012 JS\""
  },
  "addresses": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^[^\\[\\]{}<>\\r\\n]*$"
   },
   "maxItems": 50,
   "description": "Dutch addresses to check and geocode, one per line, as people write them: street + house number"
  },
  "houseNumber": {
   "type": "integer",
   "maximum": 99999,
   "minimum": 1,
   "description": "House number within `postcode`, e.g. 1"
  },
  "houseNumberTo": {
   "type": "integer",
   "maximum": 99999,
   "minimum": 1,
   "description": "Last house number of a range starting at houseNumber, inclusive, e.g. 20 for 1-20"
  },
  "houseNumberAddition": {
   "type": "string",
   "pattern": "^[A-Za-z0-9\\s\\-/.]{0,12}$",
   "description": "House letter and/or addition for a single houseNumber"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/dutch-address-lookup-bag-pdok-38f1b660/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.boscolabs.dev](https://www.zero.xyz/host/api.boscolabs.dev/llms.txt)
