# GetApi BAG Address Lookup (Netherlands)

> GetApi BAG Address Lookup (Netherlands) is a paid API for AI agents from api.getapi.nl, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Looks up detailed Dutch BAG (Basisregistraties Adressen en Gebouwen) address data including coordinates, building metadata, and official registration details for a given Dutch address.

## Facts

- Endpoint: GET https://api.getapi.nl/api/v1/kadaster/bag/address
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/getapi-bag-address-lookup-netherlands-f40f2860
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qlm9buHFmX-jDb9f4iX0G

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 getapi-bag-address-lookup-netherlands-f40f2860
```

Example prompt: Can you look up the official BAG address details for Damrak 1, 1012LG Amsterdam — I need the coordinates, build year, surface area, and official BAG identifiers.

## When to prefer this

Use this endpoint when you need authoritative Dutch address data from the official BAG national registry, including geocoordinates, building metadata, and official BAG identifiers. Prefer this over generic geocoding APIs when you specifically need Netherlands addresses with official building registration data (build year, surface area, usage purpose, BAG IDs). Ideal for real estate, logistics, address validation, and compliance workflows involving Dutch properties.

## Known failure modes

- Address not found in BAG registry — returns found: false
- Invalid or malformed address input — may return 400 or empty result
- Address exists but has been demolished or deregistered — status may indicate retired
- Ambiguous address (missing house number) — may return incorrect or no match
- Rate limiting or payment failure — returns 402 Payment Required

## How this service works

Ontdek, test en integreer krachtige API's voor web scraping, e-mailvalidatie, geolocatie
    en meer. Gratis starten.

## Output

Returns a JSON object with a 'found' boolean and a nested 'address' object containing: latitude, longitude, city, postcode, street, house number, house letter, house number addition, build year, surface area in m2, building status, usage purposes, document date and number, short name, address lines, BAG pand IDs, BAG woonplaats ID, BAG openbare ruimte ID, BAG verblijfsobject ID, BAG nummeraanduiding ID, municipality, whether the address is observed or secondary, and secondary address IDs.

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "properties": {
    "queryParams": {
     "type": "object",
     "properties": {
      "postcode": "1011AB",
      "house_letter": "value",
      "house_number": 1,
      "house_number_addition": "value"
     }
    }
   }
  },
  "output": {
   "properties": {
    "example": {
     "found": true,
     "address": {
      "lat": 52.3745,
      "lon": 4.8986,
      "city": "Amsterdam",
      "type": "residence",
      "status": "in_use",
      "street": "Damrak",
      "postcode": "1012LG",
      "build_year": 1900,
      "occurrence": null,
      "short_name": "Damrak",
      "is_observed": false,
      "address_line": "Damrak 1",
      "bag_pand_ids": [
       "0363100012165277"
      ],
      "house_letter": null,
      "house_number": 1,
      "municipality": "Amsterdam",
      "document_date": "2019-11-22",
      "usage_purposes": [
       "retail"
      ],
      "document_number": "19SZ2048",
      "surface_area_m2": 312,
      "in_investigation": null,
      "bag_woonplaats_id": "3594",
      "address_line_postal": "1012 LG  AMSTERDAM",
      "is_secondary_address": false,
      "house_number_addition": null,
      "secondary_address_ids": [],
      "bag_openbare_ruimte_id": "0363300000006316",
      "bag_verblijfsobject_id": "0363010000218908",
      "bag_nummeraanduiding_id": "0363200000218908"
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "found": true,
  "address": {
   "lat": 52.3745,
   "lon": 4.8986,
   "city": "Amsterdam",
   "type": "residence",
   "status": "in_use",
   "street": "Damrak",
   "postcode": "1012LG",
   "build_year": 1900,
   "occurrence": null,
   "short_name": "Damrak",
   "is_observed": false,
   "address_line": "Damrak 1",
   "bag_pand_ids": [
    "0363100012165277"
   ],
   "house_letter": null,
   "house_number": 1,
   "municipality": "Amsterdam",
   "document_date": "2019-11-22",
   "usage_purposes": [
    "retail"
   ],
   "document_number": "19SZ2048",
   "surface_area_m2": 312,
   "in_investigation": null,
   "bag_woonplaats_id": "3594",
   "address_line_postal": "1012 LG  AMSTERDAM",
   "is_secondary_address": false,
   "house_number_addition": null,
   "secondary_address_ids": [],
   "bag_openbare_ruimte_id": "0363300000006316",
   "bag_verblijfsobject_id": "0363010000218908",
   "bag_nummeraanduiding_id": "0363200000218908"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/getapi-bag-address-lookup-netherlands-f40f2860/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.getapi.nl](https://www.zero.xyz/host/api.getapi.nl/llms.txt)