# GetApi Kadaster BAG Address Suggest

> GetApi Kadaster BAG Address Suggest 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-13).

Returns Dutch address autocomplete suggestions from the Kadaster BAG (Basisregistratie Adressen en Gebouwen) registry given a partial address query

## Facts

- Endpoint: GET https://api.getapi.nl/api/v1/kadaster/bag/address-suggest
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/getapi-kadaster-bag-address-suggest-702ff32c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ssHlfDB-g-i2qA_yhvzDa

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-kadaster-bag-address-suggest-702ff32c
```

Example prompt: Can you suggest Dutch addresses that match 'Damrak 1 Amsterdam' using the Kadaster BAG registry and give me the official BAG address ID and postcode?

## When to prefer this

Use this endpoint when you need authoritative Dutch address autocomplete or resolution backed by the official Kadaster BAG registry, especially when you need BAG identifiers (verblijfsobject ID, nummeraanduiding ID) for downstream property lookups, address validation, or form pre-filling in the Netherlands. Prefer this over generic geocoders when official Dutch government cadastral identifiers are required.

## Known failure modes

- No suggestions returned for highly ambiguous or misspelled input
- Empty suggestions array if query does not match any BAG record
- Payment required (402) if x402 payment header is not provided
- Rate limiting or authentication errors if API key is missing or invalid
- Partial matches only for very short or generic query strings

## How this service works

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

## Output

A JSON object containing a 'suggestions' array, where each entry includes a unique BAG address ID (adr-prefixed), type ('adres'), a human-readable label (street + postcode + city), postcode, house number, verblijfsobject ID, and nummeraanduiding ID — all sourced from the official Dutch Kadaster BAG database.

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "properties": {
    "queryParams": {
     "type": "object",
     "properties": {
      "q": "Amsterdam",
      "limit": 1
     }
    }
   }
  },
  "output": {
   "properties": {
    "example": {
     "suggestions": [
      {
       "id": "adr-1234567890123456",
       "type": "adres",
       "label": "Damrak 1, 1012LG Amsterdam",
       "postcode": "1012LG",
       "house_number": 1,
       "verblijfsobject_id": "1234567890123456",
       "nummeraanduiding_id": "1234567890123456"
      },
      {
       "id": "adr-1234567890123457",
       "type": "adres",
       "label": "Damrak 2, 1012LG Amsterdam",
       "postcode": "1012LG",
       "house_number": 2,
       "verblijfsobject_id": "1234567890123457",
       "nummeraanduiding_id": "1234567890123457"
      }
     ]
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "suggestions": [
   {
    "id": "adr-1234567890123456",
    "type": "adres",
    "label": "Damrak 1, 1012LG Amsterdam",
    "postcode": "1012LG",
    "house_number": 1,
    "verblijfsobject_id": "1234567890123456",
    "nummeraanduiding_id": "1234567890123456"
   },
   {
    "id": "adr-1234567890123457",
    "type": "adres",
    "label": "Damrak 2, 1012LG Amsterdam",
    "postcode": "1012LG",
    "house_number": 2,
    "verblijfsobject_id": "1234567890123457",
    "nummeraanduiding_id": "1234567890123457"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/getapi-kadaster-bag-address-suggest-702ff32c/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)