// api.postcodetools.nl/v1

API Endpoints

Overzicht van alle beschikbare endpoints. Elk endpoint retourneert JSON en vereist authenticatie, tenzij anders vermeld.

57 endpointsBekijk de interactieve API-documentatie voor volledige details

// CONTENTSInhoudsopgave

Adressen9 Geocodering2 Postcodes5 Steden3 Straten3 Gemeenten3 Provincies2 Gebouwen4 Verblijfsobjecten2 Statistieken6 Data & Status4 Export3 MCP Server (AI)11

// ADDRESSES9

GET/addresses/lookup

Zoek een specifiek adres op basis van postcode en huisnummer

Parameters

Naam	Type	Verplicht	Beschrijving
postcode	string	Verplicht	Nederlandse postcode (formaat: 1234AB, 6 tekens)
number	integer	Verplicht	Huisnummer
letter	string	Optioneel	Optionele huisletter (A, B, etc.)
addition	string	Optioneel	Optionele huisnummertoevoeging (I, II, bis, etc.)
include	string	Optioneel	Inclusief geometriedata (waarde: geometry)

Voorbeelden

curl "https://postcodetools.nl/api/v1/addresses/lookup?postcode=2514GL&number=78" \
  -H "Authorization: Bearer <api-key>"

GET/demo/lookup

Publieke demo van adres-opzoeking. Geen authenticatie vereist — gelimiteerd tot 10 verzoeken per minuut en 200 per dag per IP. Gebruik een echte API-sleutel voor productieverkeer.

Parameters

Naam	Type	Verplicht	Beschrijving
postcode	string	Verplicht	Nederlandse postcode (formaat: 1234AB, 6 tekens)
number	integer	Verplicht	Huisnummer

Voorbeelden

curl "https://postcodetools.nl/api/v1/demo/lookup?postcode=2514GL&number=78"

GET/addresses/search

Zoek adressen met vrije tekst (gepagineerd)

Parameters

Naam	Type	Verplicht	Beschrijving
q	string	Verplicht	Zoekterm (minimaal 2 tekens)
per_page	integer	Optioneel	Resultaten per pagina (1-100, standaard: 25)
page	integer	Optioneel	Paginanummer (standaard: 1)
include	string	Optioneel	Inclusief geometriedata (waarde: geometry)

Response

{
  "data": [
    {
      "nummeraanduiding_id": "0363200000123456",
      "type": "verblijfsobject",
      "huisnummer": 123,
      "huisletter": null,
      "huisnummertoevoeging": null,
      "postcode": "1015CJ",
      "straatnaam": "Keizersgracht",
      "verkorte_straatnaam": null,
      "woonplaats_naam": "Amsterdam",
      "woonplaats_id": "3594",
      "gemeente_naam": "Amsterdam",
      "gemeente_code": "0363",
      "provincie_naam": "Noord-Holland",
      "gebruiksdoel": ["woonfunctie"],
      "oppervlakte": 95,
      "status": "Naamgeving uitgegeven",
      "pand_id": "0363100012345678",
      "adresseerbaar_object_id": "0363010000000001",
      "bouwjaar": 1670,
      "latitude": 52.3702,
      "longitude": 4.8952,
      "rd_x": 121687.5,
      "rd_y": 487350.3,
      "full_address": "Keizersgracht 123, 1015CJ Amsterdam"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 25,
    "total": 1
  },
  "links": {
    "first": "...",
    "last": "...",
    "prev": null,
    "next": null
  }
}

GET/addresses/autocomplete

Autocomplete adressuggesties voor zoeken-terwijl-je-typt

Parameters

Naam	Type	Verplicht	Beschrijving
q	string	Verplicht	Zoekterm (minimaal 2 tekens)
limit	integer	Optioneel	Maximaal aantal resultaten (1-20, standaard: 10)

Response

{
  "data": [
    {
      "id": "0363200000123456",
      "label": "Keizersgracht 123, 1015CJ Amsterdam",
      "postcode": "1015CJ",
      "city": "Amsterdam"
    },
    {
      "id": "0363200000123457",
      "label": "Keizersgracht 125, 1015CJ Amsterdam",
      "postcode": "1015CJ",
      "city": "Amsterdam"
    }
  ]
}

GET/addresses/{nummeraanduidingId}

Haal een enkel adres op via BAG nummeraanduiding ID

Parameters

Naam	Type	Verplicht	Beschrijving
nummeraanduidingId	string	Verplicht	BAG nummeraanduiding-identificatie (16 cijfers)
include	string	Optioneel	Inclusief geometriedata (waarde: geometry)

Response

{
  "data": {
    "nummeraanduiding_id": "0518200000123456",
    "type": "verblijfsobject",
    "huisnummer": 78,
    "huisletter": null,
    "huisnummertoevoeging": null,
    "postcode": "2514GL",
    "straatnaam": "Kneuterdijk",
    "verkorte_straatnaam": null,
    "woonplaats_naam": "'s-Gravenhage",
    "woonplaats_id": "1245",
    "gemeente_naam": "'s-Gravenhage",
    "gemeente_code": "0518",
    "provincie_naam": "Zuid-Holland",
    "gebruiksdoel": ["kantoorfunctie"],
    "oppervlakte": 240,
    "status": "Naamgeving uitgegeven",
    "pand_id": "0518100000123456",
    "adresseerbaar_object_id": "0363010000000001",
    "bouwjaar": 1842,
    "latitude": 52.0815,
    "longitude": 4.3118,
    "rd_x": 81548,
    "rd_y": 454640,
    "full_address": "Kneuterdijk 78, 2514GL 's-Gravenhage"
  }
}

GET/addresses/batch

Batch-opvraging van meerdere adressen via kommagescheiden BAG IDs (max 100)

Parameters

Naam	Type	Verplicht	Beschrijving
ids	string	Verplicht	Kommagescheiden BAG nummeraanduiding IDs (max 100)
include	string	Optioneel	Inclusief geometriedata (waarde: geometry)

Response

{
  "data": [
    {
      "nummeraanduiding_id": "0518200000000001",
      "type": "verblijfsobject",
      "huisnummer": 1,
      "huisletter": null,
      "huisnummertoevoeging": null,
      "postcode": "2514GL",
      "straatnaam": "Kneuterdijk",
      "verkorte_straatnaam": null,
      "woonplaats_naam": "'s-Gravenhage",
      "woonplaats_id": "1245",
      "gemeente_naam": "'s-Gravenhage",
      "gemeente_code": "0518",
      "provincie_naam": "Zuid-Holland",
      "gebruiksdoel": ["woonfunctie"],
      "oppervlakte": 110,
      "status": "Naamgeving uitgegeven",
      "pand_id": "0518100000123456",
      "adresseerbaar_object_id": "0363010000000001",
      "bouwjaar": 1842,
      "latitude": 52.0815,
      "longitude": 4.3118,
      "rd_x": 81548,
      "rd_y": 454640,
      "full_address": "Kneuterdijk 1, 2514GL 's-Gravenhage"
    }
  ]
}

GET/addresses/validate

Valideer of een adres bestaat en krijg suggesties als het niet bestaat

Parameters

Naam	Type	Verplicht	Beschrijving
postcode	string	Verplicht	Nederlandse postcode (formaat: 1234AB, 6 tekens)
number	integer	Verplicht	Huisnummer
letter	string	Optioneel	Optionele huisletter (A, B, etc.)
addition	string	Optioneel	Optionele huisnummertoevoeging (I, II, bis, etc.)

Response

{
  "data": {
    "valid": false,
    "address": null,
    "suggestions": [
      {
        "nummeraanduiding_id": "0518200000123457",
        "type": "verblijfsobject",
        "huisnummer": 80,
        "huisletter": null,
        "huisnummertoevoeging": null,
        "postcode": "2514GL",
        "straatnaam": "Kneuterdijk",
        "verkorte_straatnaam": null,
        "woonplaats_naam": "'s-Gravenhage",
        "woonplaats_id": "1245",
        "gemeente_naam": "'s-Gravenhage",
        "gemeente_code": "0518",
        "provincie_naam": "Zuid-Holland",
        "gebruiksdoel": ["woonfunctie"],
        "oppervlakte": 110,
        "status": "Naamgeving uitgegeven",
        "pand_id": "0518100000123457",
        "adresseerbaar_object_id": "0363010000000002",
        "bouwjaar": 1842,
        "latitude": 52.0816,
        "longitude": 4.3119,
        "rd_x": 81550,
        "rd_y": 454643,
        "full_address": "Kneuterdijk 80, 2514GL 's-Gravenhage"
      }
    ]
  }
}

GET/addresses/nearby

Vind adressen in de buurt van een geografische locatie (WGS84 of RD-coordinaten)

Parameters

Naam	Type	Verplicht	Beschrijving
lat	number	Verplicht	Breedtegraad in WGS84 (bijv. 52.3702)
lng	number	Verplicht	Lengtegraad in WGS84 (bijv. 4.8952)
rd_x	number	Optioneel	RD X-coordinaat (alternatief voor lat/lng, bijv. 121000)
rd_y	number	Optioneel	RD Y-coordinaat (alternatief voor lat/lng, bijv. 487000)
radius_km	number	Optioneel	Zoekradius in kilometers (standaard: 1, max: 20)
limit	integer	Optioneel	Maximaal aantal resultaten (1-100, standaard: 25)
include	string	Optioneel	Inclusief geometriedata (waarde: geometry)

Response

{
  "data": [
    {
      "nummeraanduiding_id": "0363200000123456",
      "type": "verblijfsobject",
      "huisnummer": 1,
      "huisletter": null,
      "huisnummertoevoeging": null,
      "postcode": "1012JS",
      "straatnaam": "Dam",
      "verkorte_straatnaam": null,
      "woonplaats_naam": "Amsterdam",
      "woonplaats_id": "3594",
      "gemeente_naam": "Amsterdam",
      "gemeente_code": "0363",
      "provincie_naam": "Noord-Holland",
      "gebruiksdoel": ["woonfunctie"],
      "oppervlakte": 95,
      "status": "Naamgeving uitgegeven",
      "pand_id": "0363100012345678",
      "adresseerbaar_object_id": "0363010000000001",
      "bouwjaar": 1670,
      "latitude": 52.3731,
      "longitude": 4.8932,
      "rd_x": 121687.5,
      "rd_y": 487350.3,
      "full_address": "Dam 1, 1012JS Amsterdam",
      "distance_km": 0.042
    }
  ]
}

GET/addresses/within-bbox

Vind adressen binnen een geografisch begrenzingskader

Parameters

Naam	Type	Verplicht	Beschrijving
north	number	Verplicht	Noordelijke grens breedtegraad
south	number	Verplicht	Zuidelijke grens breedtegraad
east	number	Verplicht	Oostelijke grens lengtegraad
west	number	Verplicht	Westelijke grens lengtegraad
limit	integer	Optioneel	Maximaal aantal resultaten (1-1000, standaard: 100)
include	string	Optioneel	Inclusief geometriedata (waarde: geometry)

Response

{
  "data": [
    {
      "nummeraanduiding_id": "0363200000123456",
      "type": "verblijfsobject",
      "huisnummer": 1,
      "huisletter": null,
      "huisnummertoevoeging": null,
      "postcode": "1012JS",
      "straatnaam": "Dam",
      "verkorte_straatnaam": null,
      "woonplaats_naam": "Amsterdam",
      "woonplaats_id": "3594",
      "gemeente_naam": "Amsterdam",
      "gemeente_code": "0363",
      "provincie_naam": "Noord-Holland",
      "gebruiksdoel": ["woonfunctie"],
      "oppervlakte": 95,
      "status": "Naamgeving uitgegeven",
      "pand_id": "0363100012345678",
      "adresseerbaar_object_id": "0363010000000001",
      "bouwjaar": 1670,
      "latitude": 52.3731,
      "longitude": 4.8932,
      "rd_x": 121687.5,
      "rd_y": 487350.3,
      "full_address": "Dam 1, 1012JS Amsterdam"
    }
  ]
}

// GEOCODE2

GET/geocode/forward

Forward geocodering: converteer een adres naar geografische coordinaten

Parameters

Naam	Type	Verplicht	Beschrijving
postcode	string	Optioneel	Nederlandse postcode (formaat: 1234AB, 6 tekens)
number	integer	Optioneel	Huisnummer
q	string	Optioneel	Vrije tekst adresquery (alternatief voor postcode+nummer)
letter	string	Optioneel	Optionele huisletter (A, B, etc.)
addition	string	Optioneel	Optionele huisnummertoevoeging (I, II, bis, etc.)

Response

{
  "data": {
    "address": {
      "nummeraanduiding_id": "0363200000123456",
      "type": "verblijfsobject",
      "huisnummer": 123,
      "huisletter": null,
      "huisnummertoevoeging": null,
      "postcode": "1012AB",
      "straatnaam": "Keizersgracht",
      "verkorte_straatnaam": null,
      "woonplaats_naam": "Amsterdam",
      "woonplaats_id": "3594",
      "gemeente_naam": "Amsterdam",
      "gemeente_code": "0363",
      "provincie_naam": "Noord-Holland",
      "gebruiksdoel": ["woonfunctie"],
      "oppervlakte": 95,
      "status": "Naamgeving uitgegeven",
      "pand_id": "0363100012345678",
      "adresseerbaar_object_id": "0363010000000001",
      "bouwjaar": 1670,
      "latitude": 52.3702,
      "longitude": 4.8952,
      "rd_x": 121687.5,
      "rd_y": 487350.3,
      "full_address": "Keizersgracht 123, 1012AB Amsterdam"
    },
    "coordinates": {
      "wgs84": { "latitude": 52.3702, "longitude": 4.8952 },
      "rd": { "x": 121687.5, "y": 487350.3 }
    },
    "geojson": {
      "type": "Feature",
      "geometry": { "type": "Point", "coordinates": [4.8952, 52.3702] },
      "properties": {
        "nummeraanduiding_id": "0363200000123456",
        "full_address": "Keizersgracht 123, 1012AB Amsterdam",
        "postcode": "1012AB",
        "huisnummer": 123,
        "straatnaam": "Keizersgracht",
        "woonplaats": "Amsterdam",
        "source": "BAG"
      }
    }
  }
}

GET/geocode/reverse

Reverse geocodering: vind het dichtstbijzijnde adres bij gegeven coordinaten

Parameters

Naam	Type	Verplicht	Beschrijving
lat	number	Verplicht	Breedtegraad in WGS84 (bijv. 52.3702)
lng	number	Verplicht	Lengtegraad in WGS84 (bijv. 4.8952)
rd_x	number	Optioneel	RD X-coordinaat (alternatief voor lat/lng, bijv. 121000)
rd_y	number	Optioneel	RD Y-coordinaat (alternatief voor lat/lng, bijv. 487000)
radius_m	number	Optioneel	Zoekradius in meters (standaard: 100, max: 1000)

Response

{
  "data": {
    "address": {
      "nummeraanduiding_id": "0363200000123456",
      "type": "verblijfsobject",
      "huisnummer": 1,
      "huisletter": null,
      "huisnummertoevoeging": null,
      "postcode": "1012JS",
      "straatnaam": "Dam",
      "verkorte_straatnaam": null,
      "woonplaats_naam": "Amsterdam",
      "woonplaats_id": "3594",
      "gemeente_naam": "Amsterdam",
      "gemeente_code": "0363",
      "provincie_naam": "Noord-Holland",
      "gebruiksdoel": ["woonfunctie"],
      "oppervlakte": 110,
      "status": "Naamgeving uitgegeven",
      "pand_id": "0363100012345678",
      "adresseerbaar_object_id": "0363010000000001",
      "bouwjaar": 1670,
      "latitude": 52.3731,
      "longitude": 4.8932,
      "rd_x": 121540,
      "rd_y": 487669,
      "full_address": "Dam 1, 1012JS Amsterdam"
    },
    "distance_meters": 12.5,
    "query": {
      "latitude": 52.3731,
      "longitude": 4.8932
    }
  }
}

// POSTCODES5

GET/postcodes/{postcode}

Haal alle adressen op voor een specifieke postcode (gepagineerd)

Parameters

Naam	Type	Verplicht	Beschrijving
postcode	string	Verplicht	Postcode als URL-padparameter (6 tekens)
per_page	integer	Optioneel	Resultaten per pagina (1-100, standaard: 25)
page	integer	Optioneel	Paginanummer (standaard: 1)
include	string	Optioneel	Inclusief geometriedata (waarde: geometry)

Response

{
  "data": [
    {
      "nummeraanduiding_id": "0363200000123456",
      "type": "verblijfsobject",
      "huisnummer": 1,
      "huisletter": null,
      "huisnummertoevoeging": null,
      "postcode": "1012AB",
      "straatnaam": "Keizersgracht",
      "verkorte_straatnaam": null,
      "woonplaats_naam": "Amsterdam",
      "woonplaats_id": "3594",
      "gemeente_naam": "Amsterdam",
      "gemeente_code": "0363",
      "provincie_naam": "Noord-Holland",
      "gebruiksdoel": ["woonfunctie"],
      "oppervlakte": 95,
      "status": "Naamgeving uitgegeven",
      "pand_id": "0363100012345678",
      "adresseerbaar_object_id": "0363010000000001",
      "bouwjaar": 1670,
      "latitude": 52.3702,
      "longitude": 4.8952,
      "rd_x": 121687.5,
      "rd_y": 487350.3,
      "full_address": "Keizersgracht 1, 1012AB Amsterdam"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 3,
    "per_page": 25,
    "total": 68
  },
  "links": {
    "first": "...",
    "last": "...",
    "prev": null,
    "next": "..."
  }
}

GET/postcodes/{postcode}/range

Haal het huisnummerbereik (min/max) op voor een postcode

Parameters

Naam	Type	Verplicht	Beschrijving
postcode	string	Verplicht	Postcode als URL-padparameter (6 tekens)

Response

{
  "data": {
    "postcode": "1012AB",
    "min_number": 1,
    "max_number": 199,
    "count": 68,
    "street": "Keizersgracht",
    "city": "Amsterdam"
  }
}

GET/postcodes/validate/{postcode}

Controleer of een postcode bestaat in de BAG

Parameters

Naam	Type	Verplicht	Beschrijving
postcode	string	Verplicht	Postcode als URL-padparameter (6 tekens)

Response

{
  "data": {
    "valid": true,
    "postcode": "1012AB",
    "street": "Keizersgracht",
    "city": "Amsterdam",
    "municipality": "Amsterdam",
    "province": "Noord-Holland"
  }
}

GET/postcodes/nearby

Vind alle postcodes binnen een straal van een adres

Parameters

Naam	Type	Verplicht	Beschrijving
postcode	string	Verplicht	Postcode van het startadres (6 tekens)
number	integer	Verplicht	Huisnummer van het startadres
radius_km	number	Optioneel	Zoekstraal in km (0.1–20, standaard 5)
precision	integer	Optioneel	Postcode precisie: 4 (gebied) of 6 (volledig), standaard 4
lat	number	Optioneel	Breedtegraad (alternatief voor postcode/nummer)
lng	number	Optioneel	Lengtegraad (alternatief voor postcode/nummer)

Response

{
  "data": {
    "origin": {
      "postcode": "1012AB",
      "huisnummer": 1,
      "straatnaam": "Keizersgracht",
      "woonplaats_naam": "Amsterdam",
      "full_address": "Keizersgracht 1, 1012AB Amsterdam",
      "latitude": 52.3702,
      "longitude": 4.8952
    },
    "radius_km": 5,
    "precision": 4,
    "postcodes": [
      {
        "postcode": "1012",
        "city": "Amsterdam",
        "distance_km": 0.01,
        "address_count": 3421
      },
      {
        "postcode": "1013",
        "city": "Amsterdam",
        "distance_km": 0.84,
        "address_count": 2156
      }
    ],
    "total": 42
  }
}

GET/postcodes/areas

Lijst van alle 4-cijferige postcodegebieden met aantal adressen

Parameters

Naam	Type	Verplicht	Beschrijving
prefix	string	Optioneel	Filteren op postcodegebied-prefix (2-4 cijfers)
per_page	integer	Optioneel	Resultaten per pagina (1-100, standaard: 25)
page	integer	Optioneel	Paginanummer (standaard: 1)
include	string	Optioneel	Inclusief grensvlak (waarde: geometry)

Response

{
  "data": [
    {
      "area": "1012",
      "address_count": 8456,
      "sample_city": "Amsterdam"
    },
    {
      "area": "1013",
      "address_count": 6234,
      "sample_city": "Amsterdam"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 90,
    "per_page": 50,
    "total": 4500
  },
  "links": {
    "first": "...",
    "last": "...",
    "prev": null,
    "next": "..."
  }
}

// CITIES3

GET/cities

Lijst van alle Nederlandse steden met filters en paginering

Parameters

Naam	Type	Verplicht	Beschrijving
filter[naam]	string	Optioneel	Filter op stadsnaam (gedeeltelijke overeenkomst)
filter[gemeente_code]	string	Optioneel	Filter op gemeentecode
filter[provincie_naam]	string	Optioneel	Filter op provincienaam
sort	string	Optioneel	Sorteer op naam (prefix met - voor aflopend)
per_page	integer	Optioneel	Resultaten per pagina (1-100, standaard: 25)
page	integer	Optioneel	Paginanummer (standaard: 1)
include	string	Optioneel	Inclusief gerelateerde gegevens (waarden: counts, geometry)

Response

{
  "data": [
    {
      "identificatie": "3594",
      "naam": "Amsterdam",
      "gemeente_code": "0363",
      "gemeente_naam": "Amsterdam",
      "provincie_naam": "Noord-Holland",
      "status": "Woonplaats aangewezen"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 100,
    "per_page": 25,
    "total": 2478
  }
}

GET/cities/{woonplaatsId}

Haal details op van een specifieke stad via woonplaats-ID

Parameters

Naam	Type	Verplicht	Beschrijving
woonplaatsId	string	Verplicht	BAG woonplaats-identificatie
include	string	Optioneel	Inclusief gerelateerde gegevens (waarden: counts, geometry)

Response

{
  "data": {
    "identificatie": "3594",
    "naam": "Amsterdam",
    "gemeente_code": "0363",
    "gemeente_naam": "Amsterdam",
    "provincie_naam": "Noord-Holland",
    "status": "Woonplaats aangewezen"
  }
}

GET/cities/{woonplaatsId}/streets

Haal alle straten op in een stad (gepagineerd)

Parameters

Naam	Type	Verplicht	Beschrijving
woonplaatsId	string	Verplicht	BAG woonplaats-identificatie
per_page	integer	Optioneel	Resultaten per pagina (1-100, standaard: 25)
page	integer	Optioneel	Paginanummer (standaard: 1)
sort	string	Optioneel	Sorteer op naam (prefix met - voor aflopend)

Response

{
  "data": [
    {
      "identificatie": "0363300000000001",
      "naam": "Keizersgracht",
      "verkorte_naam": "Keizersgr",
      "type": "Weg",
      "woonplaats_id": "3594",
      "woonplaats_naam": "Amsterdam",
      "status": "Naamgeving uitgegeven"
    },
    {
      "identificatie": "0363300000000002",
      "naam": "Herengracht",
      "verkorte_naam": null,
      "type": "Weg",
      "woonplaats_id": "3594",
      "woonplaats_naam": "Amsterdam",
      "status": "Naamgeving uitgegeven"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 8,
    "per_page": 25,
    "total": 198
  },
  "links": {
    "first": "...",
    "last": "...",
    "prev": null,
    "next": "..."
  }
}

// STREETS3

GET/streets

Zoek straten in alle steden met filters

Parameters

Naam	Type	Verplicht	Beschrijving
filter[naam]	string	Optioneel	Filter op straatnaam (gedeeltelijke overeenkomst)
filter[woonplaats_id]	string	Optioneel	Filter op woonplaats-ID
woonplaats_id	string	Optioneel	Filter op woonplaats-ID (top-level alternatief voor filter[woonplaats_id])
city	string	Optioneel	Filter op stadsnaam (gedeeltelijke overeenkomst)
filter[type]	string	Optioneel	Filter op type (bijv. Weg)
sort	string	Optioneel	Sorteer op naam (prefix met - voor aflopend)
per_page	integer	Optioneel	Resultaten per pagina (1-100, standaard: 25)
page	integer	Optioneel	Paginanummer (standaard: 1)

Response

{
  "data": [
    {
      "identificatie": "0363300000000001",
      "naam": "Keizersgracht",
      "verkorte_naam": "Keizersgr",
      "type": "Weg",
      "woonplaats_id": "3594",
      "woonplaats_naam": "Amsterdam",
      "status": "Naamgeving uitgegeven"
    },
    {
      "identificatie": "0363300000000002",
      "naam": "Herengracht",
      "verkorte_naam": null,
      "type": "Weg",
      "woonplaats_id": "3594",
      "woonplaats_naam": "Amsterdam",
      "status": "Naamgeving uitgegeven"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 8,
    "per_page": 25,
    "total": 198
  },
  "links": {
    "first": "...",
    "last": "...",
    "prev": null,
    "next": "..."
  }
}

GET/streets/{openbareRuimteId}

Haal details op van een specifieke straat via openbare ruimte-ID

Parameters

Naam	Type	Verplicht	Beschrijving
openbareRuimteId	string	Verplicht	BAG openbare ruimte-identificatie (16 cijfers)
include	string	Optioneel	Inclusief recordaantallen (waarde: counts)

Response

{
  "data": {
    "identificatie": "0363300000000001",
    "naam": "Keizersgracht",
    "verkorte_naam": "Keizersgr",
    "type": "Weg",
    "woonplaats_id": "3594",
    "woonplaats_naam": "Amsterdam",
    "status": "Naamgeving uitgegeven"
  }
}

GET/streets/{openbareRuimteId}/addresses

Haal alle adressen op in een specifieke straat (gepagineerd)

Parameters

Naam	Type	Verplicht	Beschrijving
openbareRuimteId	string	Verplicht	BAG openbare ruimte-identificatie (16 cijfers)
per_page	integer	Optioneel	Resultaten per pagina (1-100, standaard: 25)
page	integer	Optioneel	Paginanummer (standaard: 1)
include	string	Optioneel	Inclusief geometriedata (waarde: geometry)

Response

{
  "data": [
    {
      "nummeraanduiding_id": "0363200000123456",
      "type": "verblijfsobject",
      "huisnummer": 123,
      "huisletter": null,
      "huisnummertoevoeging": null,
      "postcode": "1015CJ",
      "straatnaam": "Keizersgracht",
      "verkorte_straatnaam": null,
      "woonplaats_naam": "Amsterdam",
      "woonplaats_id": "3594",
      "gemeente_naam": "Amsterdam",
      "gemeente_code": "0363",
      "provincie_naam": "Noord-Holland",
      "gebruiksdoel": ["woonfunctie"],
      "oppervlakte": 95,
      "status": "Naamgeving uitgegeven",
      "pand_id": "0363100012345678",
      "adresseerbaar_object_id": "0363010000000001",
      "bouwjaar": 1670,
      "latitude": 52.3702,
      "longitude": 4.8952,
      "rd_x": 121687.5,
      "rd_y": 487350.3,
      "full_address": "Keizersgracht 123, 1015CJ Amsterdam"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 25,
    "total": 1
  },
  "links": {
    "first": "...",
    "last": "...",
    "prev": null,
    "next": null
  }
}

// MUNICIPALITIES3

GET/municipalities

Lijst van alle Nederlandse gemeenten met filters en paginering

Parameters

Naam	Type	Verplicht	Beschrijving
filter[gemeente_naam]	string	Optioneel	Filter op gemeentenaam (gedeeltelijke overeenkomst)
filter[provincie_naam]	string	Optioneel	Filter op provincienaam
filter[provincie_code]	string	Optioneel	Filter op provinciecode (bijv. NH, ZH)
sort	string	Optioneel	Sorteer op gemeentenaam (prefix met - voor aflopend)
per_page	integer	Optioneel	Resultaten per pagina (1-100, standaard: 25)
page	integer	Optioneel	Paginanummer (standaard: 1)
include	string	Optioneel	Inclusief gerelateerde gegevens (waarden: counts, geometry)

Response

{
  "data": [
    {
      "gemeente_code": "0363",
      "gemeente_naam": "Amsterdam",
      "provincie_naam": "Noord-Holland",
      "provincie_code": "NH"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 14,
    "per_page": 25,
    "total": 342
  }
}

GET/municipalities/{gemeenteCode}

Haal details op van een specifieke gemeente via CBS-code

Parameters

Naam	Type	Verplicht	Beschrijving
gemeenteCode	string	Verplicht	CBS-gemeentecode (4 cijfers, bijv. 0363)
include	string	Optioneel	Inclusief gerelateerde gegevens (waarden: counts, geometry)

Response

{
  "data": {
    "gemeente_code": "0363",
    "gemeente_naam": "Amsterdam",
    "provincie_naam": "Noord-Holland",
    "provincie_code": "NH"
  }
}

GET/municipalities/{gemeenteCode}/cities

Haal alle steden op binnen een gemeente

Parameters

Naam	Type	Verplicht	Beschrijving
gemeenteCode	string	Verplicht	CBS-gemeentecode (4 cijfers, bijv. 0363)
per_page	integer	Optioneel	Resultaten per pagina (1-100, standaard: 25)
page	integer	Optioneel	Paginanummer (standaard: 1)
include	string	Optioneel	Inclusief geometriedata (waarde: geometry)

Response

{
  "data": [
    {
      "identificatie": "3594",
      "naam": "Amsterdam",
      "gemeente_code": "0363",
      "gemeente_naam": "Amsterdam",
      "provincie_naam": "Noord-Holland",
      "status": "Woonplaats aangewezen"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 100,
    "per_page": 25,
    "total": 2478
  }
}

// PROVINCES2

GET/provinces

Lijst van alle 12 Nederlandse provincies met optionele tellingen

Parameters

Naam	Type	Verplicht	Beschrijving
include	string	Optioneel	Inclusief recordaantallen (waarde: counts)

Response

{
  "data": [
    { "provincie_code": "DR", "provincie_naam": "Drenthe" },
    { "provincie_code": "FL", "provincie_naam": "Flevoland" },
    { "provincie_code": "FR", "provincie_naam": "Friesland" },
    { "provincie_code": "GE", "provincie_naam": "Gelderland" },
    { "provincie_code": "GR", "provincie_naam": "Groningen" },
    { "provincie_code": "LI", "provincie_naam": "Limburg" },
    { "provincie_code": "NB", "provincie_naam": "Noord-Brabant" },
    { "provincie_code": "NH", "provincie_naam": "Noord-Holland" },
    { "provincie_code": "OV", "provincie_naam": "Overijssel" },
    { "provincie_code": "UT", "provincie_naam": "Utrecht" },
    { "provincie_code": "ZE", "provincie_naam": "Zeeland" },
    { "provincie_code": "ZH", "provincie_naam": "Zuid-Holland" }
  ]
}

GET/provinces/{provinceName}

Haal details op van een specifieke provincie via naam of code

Parameters

Naam	Type	Verplicht	Beschrijving
provinceName	string	Verplicht	Provincienaam (bijv. Noord-Holland) of code (bijv. NH)
include	string	Optioneel	Inclusief gerelateerde data (waarden: municipalities, counts)

Response

{
  "data": {
    "provincie_code": "NH",
    "provincie_naam": "Noord-Holland"
  }
}

// BUILDINGS4

GET/buildings/{pandId}

Haal gebouwdetails op via BAG pand-ID

Parameters

Naam	Type	Verplicht	Beschrijving
pandId	string	Verplicht	BAG pand-identificatie (16 cijfers)
include	string	Optioneel	Inclusief gerelateerde data (waarden: geometry, addresses, counts)

Response

{
  "data": {
    "identificatie": "0363100012345678",
    "bouwjaar": 1892,
    "status": "Pand in gebruik",
    "geconstateerd": false,
    "voorkomen_identificatie": 1,
    "begin_geldigheid": "2022-01-01",
    "eind_geldigheid": null
  }
}

GET/buildings/at-address

Vind het gebouw op een specifiek adres

Parameters

Naam	Type	Verplicht	Beschrijving
postcode	string	Verplicht	Nederlandse postcode (formaat: 1234AB, 6 tekens)
number	integer	Verplicht	Huisnummer
letter	string	Optioneel	Optionele huisletter (A, B, etc.)
addition	string	Optioneel	Optionele huisnummertoevoeging (I, II, bis, etc.)
include	string	Optioneel	Inclusief gerelateerde data (waarden: geometry, addresses, counts)

Response

{
  "data": {
    "identificatie": "0363100012345678",
    "bouwjaar": 1892,
    "status": "Pand in gebruik",
    "geconstateerd": false,
    "voorkomen_identificatie": 1,
    "begin_geldigheid": "2022-01-01",
    "eind_geldigheid": null
  }
}

GET/buildings/within-bbox

Vind gebouwen binnen een geografisch begrenzingskader

Parameters

Naam	Type	Verplicht	Beschrijving
north	number	Verplicht	Noordelijke grens breedtegraad
south	number	Verplicht	Zuidelijke grens breedtegraad
east	number	Verplicht	Oostelijke grens lengtegraad
west	number	Verplicht	Westelijke grens lengtegraad
filter[bouwjaar_min]	integer	Optioneel	Minimaal bouwjaar
filter[bouwjaar_max]	integer	Optioneel	Maximaal bouwjaar
filter[status]	string	Optioneel	Gebouwstatus (bijv. Pand in gebruik)
limit	integer	Optioneel	Maximaal aantal resultaten (1-500, standaard: 100)

Response

{
  "data": [
    {
      "identificatie": "0363100012345678",
      "bouwjaar": 1892,
      "status": "Pand in gebruik",
      "geconstateerd": false,
      "voorkomen_identificatie": 1,
      "begin_geldigheid": "2022-01-01",
      "eind_geldigheid": null
    },
    {
      "identificatie": "0363100012345679",
      "bouwjaar": 1924,
      "status": "Pand in gebruik",
      "geconstateerd": false,
      "voorkomen_identificatie": 1,
      "begin_geldigheid": "2022-01-01",
      "eind_geldigheid": null
    }
  ]
}

GET/buildings/by-year

Haal gebouwstatistieken op gegroepeerd per bouwjaar

Parameters

Naam	Type	Verplicht	Beschrijving
group_by	string	Optioneel	Groepering: year, decade (standaard) of century
gemeente_code	string	Optioneel	Filter op gemeentecode
woonplaats_id	string	Optioneel	Filter op woonplaats-ID
city	string	Optioneel	Filter op stadsnaam (gedeeltelijke overeenkomst)
min_year	integer	Optioneel	Minimaal bouwjaar
max_year	integer	Optioneel	Maximaal bouwjaar

Response

{
  "data": {
    "group_by": "decade",
    "statistics": [
      { "period": 1900, "count": 234 },
      { "period": 1910, "count": 198 },
      { "period": 1920, "count": 176 }
    ]
  }
}

// RESIDENCES2

GET/residences/{verblijfsobjectId}

Haal verblijfsobjectdetails op via ID

Parameters

Naam	Type	Verplicht	Beschrijving
verblijfsobjectId	string	Verplicht	BAG verblijfsobject-identificatie (16 cijfers)
include	string	Optioneel	Inclusief gerelateerde data (waarden: geometry, address)

Response

{
  "data": {
    "identificatie": "0363010000123456",
    "gebruiksdoel": ["woonfunctie"],
    "oppervlakte": 85,
    "status": "Verblijfsobject in gebruik",
    "pand_id": "0363100012345678",
    "hoofdadres_nummeraanduiding_id": "0363200000123456",
    "nevenadres_nummeraanduiding_ids": ["0363200000123459"],
    "latitude": 52.3702,
    "longitude": 4.8952,
    "rd_x": 121687.5,
    "rd_y": 487350.3
  }
}

GET/residences/by-purpose

Vind verblijfsobjecten gefilterd op gebruiksdoel

Parameters

Naam	Type	Verplicht	Beschrijving
purpose	string	Verplicht	Gebruiksdoel (bijv. woonfunctie, kantoorfunctie, winkelfunctie)
gemeente_code	string	Optioneel	Filter op gemeentecode
woonplaats_id	string	Optioneel	Filter op woonplaats-ID
city	string	Optioneel	Filter op stadsnaam (exacte overeenkomst)
oppervlakte_min	integer	Optioneel	Minimaal oppervlakte in m²
oppervlakte_max	integer	Optioneel	Maximaal oppervlakte in m²
per_page	integer	Optioneel	Resultaten per pagina (1-100, standaard: 25)
page	integer	Optioneel	Paginanummer (standaard: 1)

Response

{
  "data": [
    {
      "nummeraanduiding_id": "0363200000123456",
      "type": "verblijfsobject",
      "huisnummer": 123,
      "huisletter": null,
      "huisnummertoevoeging": null,
      "postcode": "1015CJ",
      "straatnaam": "Keizersgracht",
      "verkorte_straatnaam": null,
      "woonplaats_naam": "Amsterdam",
      "woonplaats_id": "3594",
      "gemeente_naam": "Amsterdam",
      "gemeente_code": "0363",
      "provincie_naam": "Noord-Holland",
      "gebruiksdoel": ["woonfunctie"],
      "oppervlakte": 85,
      "status": "Naamgeving uitgegeven",
      "pand_id": "0363100012345678",
      "adresseerbaar_object_id": "0363010000000001",
      "bouwjaar": 1670,
      "latitude": 52.3702,
      "longitude": 4.8952,
      "rd_x": 121687.5,
      "rd_y": 487350.3,
      "full_address": "Keizersgracht 123, 1015CJ Amsterdam"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 10,
    "per_page": 25,
    "total": 250
  }
}

// STATISTICS6

GET/statistics/overview

Nationaal statistiekoverzicht (totaal adressen, gebouwen, steden, gemeenten)

Dit endpoint heeft geen parameters.

Response

{
  "data": {
    "total_addresses": 9523456,
    "total_buildings": 4567890,
    "total_cities": 2478,
    "total_municipalities": 342,
    "by_type": {
      "verblijfsobject": 9123456,
      "ligplaats": 12345,
      "standplaats": 6789
    },
    "by_province": {
      "Zuid-Holland": 1876543,
      "Noord-Holland": 1543210,
      "Noord-Brabant": 1234567
    }
  }
}

GET/statistics/purposes

Statistieken per gebruiksdoel

Dit endpoint heeft geen parameters.

Response

{
  "data": {
    "purposes": {
      "woonfunctie": 8234567,
      "kantoorfunctie": 456789,
      "winkelfunctie": 234567,
      "industriefunctie": 123456,
      "bijeenkomstfunctie": 67890
    },
    "total_with_purpose": 9123456
  }
}

GET/statistics/construction-years

Gebouwstatistieken gegroepeerd per bouwjaar

Parameters

Naam	Type	Verplicht	Beschrijving
group_by	string	Optioneel	Groepering: year, decade (standaard) of century

Response

{
  "data": {
    "group_by": "decade",
    "statistics": [
      { "period": 1900, "count": 234567 },
      { "period": 1910, "count": 198765 },
      { "period": 1920, "count": 176543 }
    ],
    "oldest": 1200,
    "newest": 2026,
    "total_buildings": 4567890
  }
}

GET/statistics/municipality/{gemeenteCode}

Statistieken voor een specifieke gemeente

Parameters

Naam	Type	Verplicht	Beschrijving
gemeenteCode	string	Verplicht	CBS-gemeentecode (4 cijfers, bijv. 0363)

Response

{
  "data": {
    "gemeente_code": "0363",
    "gemeente_naam": "Amsterdam",
    "provincie_naam": "Noord-Holland",
    "total_addresses": 524876,
    "total_buildings": 89543,
    "total_cities": 1,
    "by_type": {
      "verblijfsobject": 512345,
      "ligplaats": 2345,
      "standplaats": 186
    },
    "by_purpose": {
      "woonfunctie": 423456,
      "winkelfunctie": 23456,
      "kantoorfunctie": 45678,
      "industriefunctie": 12345,
      "bijeenkomstfunctie": 6789
    }
  }
}

GET/statistics/city/{woonplaatsId}

Statistieken voor een specifieke stad

Parameters

Naam	Type	Verplicht	Beschrijving
woonplaatsId	string	Verplicht	BAG woonplaats-identificatie

Response

{
  "data": {
    "woonplaats_id": "3594",
    "naam": "Amsterdam",
    "total_addresses": 524876,
    "total_buildings": 89543,
    "by_type": {
      "verblijfsobject": 512345,
      "ligplaats": 2345,
      "standplaats": 186
    }
  }
}

GET/statistics/postcode-area/{postcode}

Statistieken voor een 4-cijferig postcodegebied

Parameters

Naam	Type	Verplicht	Beschrijving
postcode	string	Verplicht	4-cijferig postcodegebied (bijv. 1012)

Response

{
  "data": {
    "postcode_area": "1012",
    "total_addresses": 8456,
    "cities": ["Amsterdam"],
    "municipalities": ["Amsterdam"],
    "by_type": {
      "verblijfsobject": 8234,
      "ligplaats": 122,
      "standplaats": 100
    }
  }
}

// DATA4

GET/status

Publieke statuscontrole (geen authenticatie vereist)

Dit endpoint heeft geen parameters.

Response

{
  "status": "healthy",
  "checks": {
    "database": "ok",
    "cache": "ok",
    "bag_data": "ok"
  },
  "timestamp": "2026-02-17T10:00:00+00:00"
}

GET/version

Haal BAG-dataversie en recordaantallen op

Dit endpoint heeft geen parameters.

Response

{
  "data": {
    "bag_version": "2026-02-15",
    "last_import": "2026-02-15T03:00:00+00:00",
    "counts": {
      "addresses": 9523456,
      "buildings": 4567890,
      "cities": 2478,
      "municipalities": 342
    },
    "api_version": "v1"
  }
}

GET/changes/summary

Samenvatting van BAG-datawijzigingen sinds een datum

Parameters

Naam	Type	Verplicht	Beschrijving
since	string	Optioneel	Datum voor wijzigingsoverzicht (JJJJ-MM-DD formaat)

Response

{
  "data": {
    "since": "2026-01-01T00:00:00+00:00",
    "imports": [
      {
        "id": 12,
        "completed_at": "2026-01-15T03:00:00+00:00",
        "records_processed": 9500000
      }
    ],
    "import_count": 1,
    "current_counts": {
      "addresses": 9523456,
      "buildings": 4567890
    }
  }
}

GET/openapi.yaml

OpenAPI 3.0-specificatie (YAML) — automatisch gegenereerd, één uur gecached. Te gebruiken om getypeerde clients te genereren of te importeren in Postman/Insomnia.

Dit endpoint heeft geen parameters.

Voorbeelden

curl "https://postcodetools.nl/api/v1/openapi.yaml" \
  -o openapi.yaml

// EXPORT3

POST/export/addresses

Vraag een asynchrone adresdata-export aan (retourneert job-ID)

Parameters

Naam	Type	Verplicht	Beschrijving
postcode_area	string	Optioneel	4-cijferig postcodegebied (bijv. 1012)
gemeente_code	string	Optioneel	Filter op gemeentecode
woonplaats_id	string	Optioneel	Filter op woonplaats-ID
provincie_naam	string	Optioneel	Filter op provincienaam
type	string	Optioneel	Adrestype: verblijfsobject, ligplaats of standplaats
format	string	Optioneel	Uitvoerformaat: csv (standaard) of json

Response

{
  "data": {
    "job_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "pending",
    "message": "Export job queued. Check status at /api/v1/export/{jobId}"
  }
}

GET/export/{jobId}

Controleer de status van een exporttaak

Parameters

Naam	Type	Verplicht	Beschrijving
jobId	string	Verplicht	Export taak UUID

Response

{
  "data": {
    "job_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "completed",
    "created_at": "2026-02-17T10:00:00+00:00",
    "updated_at": "2026-02-17T10:02:00+00:00",
    "total_records": 52487,
    "processed_records": 52487,
    "progress": 100,
    "download_url": "https://postcodetools.nl/api/v1/export/550e8400.../download",
    "file_size": 15234567
  }
}

GET/export/{jobId}/download

Download een voltooid exportbestand

Parameters

Naam	Type	Verplicht	Beschrijving
jobId	string	Verplicht	Export taak UUID

// MCP11

Model Context Protocol (MCP) Server

AI-native interface voor het opvragen van Nederlandse adresgegevens

De PostcodeTools MCP-server stelt AI-assistenten (zoals Claude, ChatGPT en anderen) in staat om direct Nederlandse BAG-adresgegevens op te vragen via het Model Context Protocol. Het biedt tools voor adres opzoeken, geocodering, gebouwinformatie en statistieken, plus resources voor versie- en overzichtsgegevens.

EndpointPOST /mcp

ProtocolJSON-RPC 2.0

AuthenticatieBearer Token

MCP Tools 9

TOOLlookup_address

Zoek een Nederlands adres op aan de hand van postcode en huisnummer. Retourneert volledige adresdetails inclusief straat, woonplaats, gemeente en coördinaten.

Parameters

Naam	Type	Verplicht	Beschrijving
postcode	string	Verplicht	Nederlandse postcode (formaat: 1234AB, 6 tekens)
number	integer	Verplicht	Huisnummer
letter	string	Optioneel	Optionele huisletter (A, B, etc.)
addition	string	Optioneel	Optionele huisnummertoevoeging (I, II, bis, etc.)
include_geometry	boolean	Optioneel	Voeg GeoJSON-geometrie toe aan de response (standaard: false)

TOOLsearch_addresses

Vrije-tekst zoeken naar Nederlandse adressen. Zoek op straatnaam, woonplaats, postcode of een combinatie. Retourneert overeenkomende adressen met volledige details.

Parameters

Naam	Type	Verplicht	Beschrijving
q	string	Verplicht	Zoekopdracht (straatnaam, woonplaats, postcode of combinatie)
limit	integer	Optioneel	Maximaal aantal resultaten (1-50, standaard: 10)

TOOLget_postcode_info

Haal alle adressen en informatie op voor een Nederlandse postcode. Retourneert straatnaam, woonplaats en alle huisnummers van die postcode.

Parameters

Naam	Type	Verplicht	Beschrijving
postcode	string	Verplicht	Nederlandse postcode (formaat: 1234AB, 6 tekens)
include_geometry	boolean	Optioneel	Voeg GeoJSON-geometrie toe aan de response (standaard: false)

TOOLget_nearby_postcodes

Vind postcodes binnen een straal van een gegeven adres. Retourneert nabijgelegen 4-cijferige postcodegebieden met afstanden en aantallen adressen.

Parameters

Naam	Type	Verplicht	Beschrijving
postcode	string	Optioneel	Nederlandse postcode (6 tekens). Verplicht tenzij lat+lng worden meegegeven.
number	integer	Optioneel	Huisnummer. Verplicht tenzij lat+lng worden meegegeven.
lat	number	Optioneel	Breedtegraad in WGS84 (bijv. 52.3702)
lng	number	Optioneel	Lengtegraad in WGS84 (bijv. 4.8952)
radius	number	Optioneel	Zoekstraal in kilometers (0.1–20, standaard: 5)
precision	integer	Optioneel	Postcode precisie: 4 (gebied) of 6 (volledig), standaard 4

TOOLget_building_info

Haal bouwwerkdetails op via BAG pand-ID. Retourneert bouwjaar, status en alle adressen in het pand.

Parameters

Naam	Type	Verplicht	Beschrijving
pand_id	string	Verplicht	BAG pand-identificatie (16 cijfers)
include_geometry	boolean	Optioneel	Voeg GeoJSON-geometrie toe aan de response (standaard: false)
include_addresses	boolean	Optioneel	Voeg de adressen-array toe (standaard: true). Geef false op om dit voor grote panden over te slaan.

TOOLget_city_info

Haal informatie op over een Nederlandse woonplaats op naam. Retourneert woonplaatsdetails, statistieken en gemeentelijke informatie.

Parameters

Naam	Type	Verplicht	Beschrijving
city_name	string	Verplicht	Nederlandse woonplaatsnaam (bijv. Amsterdam, Rotterdam, Utrecht)
include_geometry	boolean	Optioneel	Voeg GeoJSON-geometrie toe aan de response (standaard: false)

TOOLgeocode_address

Converteer een Nederlands adres naar GPS-coördinaten (WGS84 latitude/longitude). Zoek met een vrije-tekstquery.

Parameters

Naam	Type	Verplicht	Beschrijving
q	string	Verplicht	Te geocoderen adres (bijv. "Keizersgracht 123 Amsterdam" of "1012AB 123")

TOOLreverse_geocode

Converteer GPS-coördinaten (WGS84) naar het dichtstbijzijnde Nederlandse adres. Zoekt het dichtstbijzijnde adres binnen een straal van 100m.

Parameters

Naam	Type	Verplicht	Beschrijving
lat	number	Optioneel	WGS84 breedtegraad. Verplicht tenzij rd_x+rd_y worden meegegeven.
lng	number	Optioneel	WGS84 lengtegraad. Verplicht tenzij rd_x+rd_y worden meegegeven.
rd_x	number	Optioneel	RD X-coordinaat (alternatief voor lat/lng, bijv. 121000)
rd_y	number	Optioneel	RD Y-coordinaat (alternatief voor lat/lng, bijv. 487000)
radius	number	Optioneel	Zoekradius in meters (standaard: 100, max: 1000)

TOOLget_statistics

Haal BAG-statistieken op voor een woonplaats, gemeente, provincie of postcodegebied. Retourneert aantallen adressen, gebouwen en uitsplitsingen per type.

Parameters

Naam	Type	Verplicht	Beschrijving
area_type	string	Verplicht	Type gebied: city, municipality, province of postcode_area
area_name	string	Verplicht	Naam of code van het gebied (bijv. "Amsterdam", "0363", "Noord-Holland", "1012")

MCP Resources 2

RESOURCEbag://data-version

Huidige BAG-dataversie en laatste update-datum. Toont wanneer de adresdata voor het laatst is geïmporteerd en hoeveel records beschikbaar zijn.

Naamdata-version

MIME Typeapplication/json

RESOURCEbag://statistics/overview

Nationaal BAG-statistiekoverzicht. Toont totalen voor adressen, gebouwen, woonplaatsen en gemeenten, plus uitsplitsingen per type en provincie.

Naamstatistics-overview

MIME Typeapplication/json