# GetApi BAG Address Lookup by ID

> GetApi BAG Address Lookup by ID 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 address and building metadata from the BAG (Basisregistratie Adressen en Gebouwen) registry by a BAG identifier

## Facts

- Endpoint: GET https://api.getapi.nl/api/v1/kadaster/bag/id
- 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-by-id-30609022
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XwHrsE5YuiBCkZN310Mvo

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-by-id-30609022
```

Example prompt: Can you look up the full address details for BAG verblijfsobject ID 0363010000218908 — I need the coordinates, postcode, build year, surface area, and usage purpose?

## When to prefer this

Use this endpoint when you already have a specific BAG identifier (verblijfsobject, nummeraanduiding, or pand ID) and need to resolve it to full Dutch address metadata including coordinates, build year, usage purpose, and status. Prefer this over general address search endpoints when you need rich BAG-specific fields like bag_pand_ids, surface_area_m2, usage_purposes, or in_investigation flags that are only available from the Dutch Kadaster registry.

## Known failure modes

- BAG ID not found — returns `found: false` with no address data
- Invalid BAG ID format — may return 400 or empty result
- BAG object exists but is not in active use — status field will indicate this
- Network timeout for slow Kadaster upstream responses
- Payment failure (402) if USDC payment is not included or insufficient

## 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, street, postcode, build year, surface area in m², usage purposes, address status, municipality, full address line, postal address line, BAG pand IDs, bag_verblijfsobject_id, bag_nummeraanduiding_id, bag_openbare_ruimte_id, bag_woonplaats_id, document date and number, house number and letter, house number addition, secondary address info, and observation/investigation flags.

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "properties": {
    "queryParams": {
     "type": "object",
     "properties": {
      "id": "1"
     }
    }
   }
  },
  "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-by-id-30609022/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)