Huischeck API

Eén adres in, één antwoord uit — met alles wat er over dat adres bekend is. Wat een register niet weet, komt terug als null; je krijgt dus altijd dezelfde structuur.

Een gewoon GET-verzoek met je sleutel als bearer-token. Meer is het niet.

curl -H "Authorization: Bearer dzt_jouw_sleutel" \
  "https://duurzame.tools/api/v1/huischeck?postcode=3333%20AK&huisnummer=12&toevoeging=A"

De postcode mag je aanleveren zoals de gebruiker hem intypt — 3333AK, 3333 AK, 3333-AK of 3333ak leveren allemaal hetzelfde op. Zit de toevoeging aan het huisnummer vast (12A, 12-A), dan splitsen we die er zelf af. Je hoeft dus niets voor te bewerken.

Het antwoord (ingekort):

{
  "adres": {
    "postcode": "3333AK",
    "huisnummer": "12",
    "toevoeging": "A",
    "straat": "Teststraat",
    "woonplaats": "Zwijndrecht",
    "volledig_adres": "Teststraat 12 A, 3333AK Zwijndrecht",
    "latitude": 51.8,
    "longitude": 4.65
  },
  "gebouw": {
    "bouwjaar": 1975,
    "oppervlakte_m2": 120,
    "gebruiksdoel": "woonfunctie",
    "inhoud_m3": 350,
    "dak_type": "schuin",
    "dak_orientatie": "zuidwest",
    "zon_geschikt_m2": 39
  },
  "energielabel": {
    "label": "C",
    "peildatum": "2020-01-01",
    "geldig_tot": "2030-01-01"
  },
  "monument": { "is_monument": false },
  "woz": [
    { "peildatum": "2025-01-01", "waarde_euro": 285000 }
  ],
  "meta": {
    "bron": "cache",
    "bijgewerkt_op": "2026-08-01T09:12:44"
  }
}

Foutmeldingen volgen de internationale afspraak daarvoor (RFC 9457): je krijgt een type, een title en een leesbare detail, zodat je in code op het type kunt sturen in plaats van op een tekst.

Wij bevragen de officiële registers, bewaren het resultaat en verversen het periodiek. Zo krijg jij snel antwoord en worden de bronnen niet onnodig belast.

BAG

Kadaster — bouwjaar, oppervlakte, gebruiksdoel

3DBAG

TU Delft — gebouwvorm, dak, inhoud

EP-Online

RVO — energielabels

Rijksmonumenten

RCE — monumentstatus

WOZ-waardeloket

WOZ-waarden per peildatum

PDOK

Geocodering van postcode naar adres

Gebouwgegevens en energielabels verversen we elke 90 dagen, WOZ-waarden jaarlijks. In het antwoord staat bij meta wanneer de gegevens voor het laatst zijn bijgewerkt.

Per sleutel geldt een maximum aantal opvragingen per minuut. Daarnaast geldt een apart maximum voor adressen die wij nog niet kennen: die kosten een rondgang langs alle registers. Adressen die al bij ons in de database staan, zijn goedkoop en snel.

Standaard staan die op 30 respectievelijk 5 per minuut. Heb je meer nodig — of juist een afgesproken maximum per maand — dan stellen we dat voor jouw sleutel in. Elk antwoord bevat headers waarin je ziet hoeveel je nog over hebt.

De tools op deze site zijn en blijven gratis. De API is dat niet: elke opvraging van een onbekend adres kost aanroepen bij externe registers, opslag en onderhoud, en die reken ik door.

De prijs hangt af van het aantal opvragingen dat je verwacht en van het soort gebruik — een eenmalige verrijking van een bestand is iets anders dan een koppeling die dagelijks meedraait. Mail me met je situatie, dan hoor je binnen een paar dagen wat het kost. Voor onderwijs, onderzoek en initiatieven zonder winstoogmerk is er ruimte om er samen uit te komen.

Wil je eerst uitproberen of het past bij wat je bouwt? Dat kan: je krijgt een proefsleutel met een beperkt aantal opvragingen.

1. Mail naar theo@vandersluijs.nl met je organisatie, waarvoor je de gegevens gaat gebruiken en hoeveel opvragingen je per maand verwacht.
2. Je krijgt een sleutel, de bijbehorende limieten en de prijsafspraak.
3. Je stuurt die sleutel mee als Authorization: Bearer … en je bent klaar. De technische handleiding met alle velden en foutcodes krijg je erbij.

Vragen, een hogere limiet nodig, of gewoon even sparren of dit past bij wat je wilt bouwen?

Theo van der Sluijs — theo@vandersluijs.nl