Endpoints

API Endpoint Referentie

Volledige technische referentie van alle beschikbare endpoints. Inclusief parameters, response formaten en voorbeelden.

Base URL:

https://api.opendataapi.nl/v1

Gebouwen

Gebouwen Endpoints

Endpoints voor het ophalen en zoeken van gebouwinformatie.

GET/buildings/{bag_id}

Gebouw ophalen op BAG ID

Haal alle beschikbare informatie op voor een specifiek gebouw op basis van het BAG identificatienummer.

Parameters

Naam	Locatie	Type	Verplicht	Beschrijving
`bag_id`	path	string	ja	Het 16-cijferige BAG identificatienummer van het gebouw

Response Velden

bag_id(string)BAG identificatienummer

status(string)Actuele pandstatus

bouwjaar(integer)Oorspronkelijk bouwjaar

oppervlakte(integer)Gebruiksoppervlakte in m²

hoogte_min(number)Minimale gebouwhoogte in meters

hoogte_max(number)Maximale gebouwhoogte in meters

daktype(string)Type dak (plat, schuin, etc.)

geometry(object)GeoJSON geometrie

Voorbeeld

# Request

GET https://api.opendataapi.nl/v1/buildings/0363100012168052

# Response

{
  "bag_id": "0363100012168052",
  "status": "Pand in gebruik",
  "bouwjaar": 1892,
  "oppervlakte": 245,
  "hoogte_min": 0,
  "hoogte_max": 12.5,
  "daktype": "plat",
  "geometry": {
    "type": "MultiPolygon",
    "coordinates": [...]
  }
}

GET/buildings/search

Zoeken op adres of postcode

Zoek gebouwen op basis van adresgegevens zoals straatnaam, huisnummer, postcode of plaatsnaam.

Parameters

Naam	Locatie	Type	Verplicht	Beschrijving
`postcode`	query	string	nee	Postcode (bijv. 1012AB)
`huisnummer`	query	string	nee	Huisnummer inclusief toevoeging
`straat`	query	string	nee	Straatnaam
`plaats`	query	string	nee	Plaatsnaam
`limit`	query	integer	nee	Maximum resultaten (standaard: 10, max: 100)

Response Velden

results(array)Array met gevonden gebouwen

total(integer)Totaal aantal resultaten

Voorbeeld

# Request

GET https://api.opendataapi.nl/v1/buildings/search?postcode=1012AB&huisnummer=1

# Response

{
  "results": [
    {
      "bag_id": "0363100012168052",
      "adres": "Dam 1, 1012AB Amsterdam",
      "bouwjaar": 1892,
      "oppervlakte": 245
    }
  ],
  "total": 1
}

GET/buildings/bbox

Gebouwen binnen bounding box

Haal alle gebouwen op binnen een opgegeven geografische rechthoek (bounding box).

Parameters

Naam	Locatie	Type	Verplicht	Beschrijving
`minLat`	query	number	ja	Minimum breedtegraad (WGS84)
`minLon`	query	number	ja	Minimum lengtegraad (WGS84)
`maxLat`	query	number	ja	Maximum breedtegraad (WGS84)
`maxLon`	query	number	ja	Maximum lengtegraad (WGS84)
`limit`	query	integer	nee	Maximum resultaten (standaard: 100, max: 1000)

Response Velden

results(array)Array met gebouwen binnen de bounding box

total(integer)Totaal aantal gebouwen in gebied

bbox(object)De opgevraagde bounding box coördinaten

Voorbeeld

# Request

GET https://api.opendataapi.nl/v1/buildings/bbox?minLat=52.36&minLon=4.89&maxLat=52.38&maxLon=4.91

# Response

{
  "results": [...],
  "total": 847,
  "bbox": {
    "minLat": 52.36,
    "minLon": 4.89,
    "maxLat": 52.38,
    "maxLon": 4.91
  }
}

3D Geometrie

3D Geometrie Endpoints

Endpoints voor het ophalen van 3D-modellen en Level of Detail data.

GET/buildings/{bag_id}/lod

Level of Detail geometrie

Haal de 3D-geometrie op in verschillende detailniveaus (LoD 1.2, LoD 1.3, LoD 2.2).

Parameters

Naam	Locatie	Type	Verplicht	Beschrijving
`bag_id`	path	string	ja	Het BAG identificatienummer
`lod`	query	string	nee	Detailniveau: lod12, lod13, lod22 (standaard: lod22)
`crs`	query	string	nee	Coördinatensysteem: RD of WGS84 (standaard: RD)

Response Velden

bag_id(string)BAG identificatienummer

lod(string)Opgevraagde Level of Detail

geometry(object)3D geometrie met Z-coördinaten

Voorbeeld

# Request

GET https://api.opendataapi.nl/v1/buildings/0363100012168052/lod?lod=lod22

# Response

{
  "bag_id": "0363100012168052",
  "lod": "lod22",
  "geometry": {
    "type": "MultiPolygonZ",
    "coordinates": [...],
    "crs": "EPSG:7415"
  }
}

GET/tiles/{z}/{x}/{y}

3D Tiles voor kaartweergave

Haal 3D Tiles op voor efficiënte weergave van gebouwen in kaartapplicaties (CesiumJS, deck.gl).

Parameters

Naam	Locatie	Type	Verplicht	Beschrijving
`z`	path	integer	ja	Zoomniveau (0-22)
`x`	path	integer	ja	Tile X-coördinaat
`y`	path	integer	ja	Tile Y-coördinaat
`format`	query	string	nee	Formaat: b3dm, glb (standaard: b3dm)

Response Velden

binary(binary)3D Tiles binaire data

Voorbeeld

# Request

GET https://api.opendataapi.nl/v1/tiles/15/16828/10899

# Response

Binary 3D Tiles data (b3dm formaat)

Historie

Historie Endpoints

Endpoints voor het ophalen van historische gebouwdata.

GET/buildings/{bag_id}/history

Gebouw historie

Bekijk de wijzigingshistorie van een gebouw, inclusief verbouwingen en statuswijzigingen.

Parameters

Naam	Locatie	Type	Verplicht	Beschrijving
`bag_id`	path	string	ja	Het BAG identificatienummer

Response Velden

bag_id(string)BAG identificatienummer

history(array)Array met historische wijzigingen

Voorbeeld

# Request

GET https://api.opendataapi.nl/v1/buildings/0363100012168052/history

# Response

{
  "bag_id": "0363100012168052",
  "history": [
    {
      "datum": "2023-01-15",
      "type": "geometrie_update",
      "beschrijving": "AHN4 update"
    },
    {
      "datum": "2020-06-01",
      "type": "status_wijziging",
      "beschrijving": "Status: Pand in gebruik"
    }
  ]
}

Klaar om te integreren?

Bekijk onze codevoorbeelden voor praktische implementaties in verschillende programmeertalen.

Codevoorbeelden Authenticatie