# Factline Dutch Address Lookup

> Factline Dutch Address Lookup is a paid API for AI agents from factline.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-11).

Validates a Dutch address and returns official BAG register data including WGS84 coordinates, municipality, province, and CBS neighbourhood/district codes

## Facts

- Endpoint: GET https://factline.dev/v1/address/lookup?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/factline-dutch-address-lookup-8f1311bf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1NsPaxcqlrBw9ZVS8-fQC

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 factline-dutch-address-lookup-8f1311bf
```

Example prompt: Can you look up the official BAG address for Laan van Meerdervoort 100 in The Hague — postcode 2517AS — and give me the coordinates and CBS neighbourhood code?

## When to prefer this

Use this endpoint when you need to validate or geocode a Dutch address against the authoritative national BAG register at very low cost ($0.002/call). Prefer it over generic geocoding APIs (e.g. Google Maps) when you specifically need official Dutch government BAG object IDs, CBS neighbourhood/district codes, or municipality codes — data that generic geocoders do not provide. It is the cheapest available option for Dutch address existence checks.

## Known failure modes

- Postcode does not exist in BAG — returns empty or error response
- House number not found at given postcode — no match returned
- Ambiguous free-text query returns multiple candidates in other_matches
- Invalid postcode format (not 4 digits + 2 letters) — schema validation error
- Non-Dutch addresses not supported — out of scope

## How this service works

API and MCP servers that let AI agents and apps check people, companies, Dutch addresses and cars against official records: sanctions and PEP lists, 10 company registers, Dutch property, rent and RDW vehicle data. From $0.001 per call.

## Output

A JSON object containing: the full structured address (street, house number, postcode, city, municipality, municipality code, province), WGS84 lat/lon coordinates, BAG address ID and addressable object ID, CBS neighbourhood name and code, CBS district name and code, and an array of other potential matches if the query was ambiguous. Also includes a related array pointing to sibling endpoints (e.g. energy label) for the resolved address.

## 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",
     "properties": {
      "q": {
       "type": "string",
       "description": "Alternative to postcode: free-text address, e.g. 'Visschersplein 1 Utrecht'"
      },
      "addition": {
       "type": "string",
       "description": "Optional house number addition, e.g. 2 or BIS"
      },
      "postcode": {
       "type": "string",
       "pattern": "^[1-9][0-9]{3} ?[A-Za-z]{2}$",
       "description": "Dutch postcode, 4 digits + 2 letters, e.g. 3511LX"
      },
      "house_letter": {
       "type": "string",
       "description": "Optional house letter, e.g. A"
      },
      "house_number": {
       "type": "integer",
       "minimum": 1,
       "description": "House number, e.g. 1"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "bag": {
   "address_id": "0518200001775789",
   "addressable_object_id": "0518010001775699"
  },
  "address": {
   "city": "'s-Gravenhage",
   "label": "Laan van Meerdervoort 100, 2517AS 's-Gravenhage",
   "street": "Laan van Meerdervoort",
   "postcode": "2517AS",
   "province": "Zuid-Holland",
   "house_letter": null,
   "house_number": 100,
   "municipality": "'s-Gravenhage",
   "municipality_code": "GM0518",
   "house_number_addition": null
  },
  "related": [
   {
    "what": "registered energy label of this home",
    "price": "0.005 USDC",
    "endpoint": "/v1/energy-label?postcode=2517AS&house_number=100"
   }
  ],
  "district": {
   "code": "WK051822",
   "name": "Wijk 22 Zeeheldenkwartier"
  },
  "location": {
   "crs": "WGS84",
   "lat": 52.08359668,
   "lon": 4.29193161
  },
  "neighbourhood": {
   "code": "BU05182245",
   "name": "Zeeheldenkwartier"
  },
  "other_matches": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/factline-dutch-address-lookup-8f1311bf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from factline.dev](https://www.zero.xyz/host/factline.dev/llms.txt)