Adressen

WOZ-gegevens op basis van een volledig adres, bv. "Kalverstraat 1, 1012NX Amsterdam".

Kost 1 credit per uniek adres. Hetzelfde adres binnen 7 dagen opnieuw opvragen kost geen extra credit; dat is een kortingsregel en geen cache, de request wordt wel echt uitgevoerd. Een opvraging die op een fout eindigt (4xx of 5xx) kost geen credit, en een antwoord zonder WOZ-waarden (een lege woz, bijvoorbeeld een pand zonder openbare WOZ-waarde) ook niet.

Zonder account vraag je een gratis proefsleutel aan met POST /Api/Proef (5 unieke adressen, 10 met het e-mailadres van de gebruiker). Met een key van een account gelden je credits en volgt 402 als je saldo leeg is, met een betaallink in detail.betaalUrl. Het resterende saldo of proeftegoed staat in de response-header X-Credits-Remaining.

adresstring required

Volledig adres met postcode of woonplaats.

geometrieboolean

Zet op true om de perceelgrenzen als GeoJSON mee te sturen. Maakt de respons flink groter.

energielabelboolean

Zet op true om het geregistreerde energielabel mee te sturen (bron: EP-Online van RVO). Kost geen extra credit. Het veld energielabel.status zegt of er een label is.

subsidietoetsboolean

Zet op true om de woning te toetsen aan de gemeentelijke regelingen met een WOZ-grens, zoals een isolatiesubsidie: per regeling of de WOZ-waarde onder de grens valt, op de peildatum die de regeling zelf noemt, plus bouwjaar en (met energielabel=true) het label. Elke gemeente is nagelezen. Kost geen extra credit. Het veld subsidietoets.status zegt of er een regeling is.

Response

Het adres is gevonden. Bevat WOZ-waarden per peildatum, BAG-gegevens, WOZ-object en percelen. Heeft het pand geen openbare WOZ-waarde, bijvoorbeeld omdat het geen woning is, dan is woz leeg en zegt wozStatus waarom (geen_woning of geen_waarde). Dat is een antwoord en geen storing: het kost geen credit en opnieuw proberen verandert niets.

adresstring nullable

wozStatusstring nullable

Of er een WOZ-waarde is, en zo niet waarom. "gevonden": woz heeft waarden. "geen_woning": geen waarde, en volgens de BAG heeft het pand geen woonfunctie; alleen van woningen is de WOZ-waarde openbaar. "geen_waarde": geen waarde, terwijl de BAG een woonfunctie noemt of het gebruiksdoel niet bekend is. Beide lege standen zijn een antwoord en geen storing: opnieuw proberen verandert niets. Een storing geeft altijd een foutstatus (502 of 503), nooit een 200 met een lege woz.

Example response

{
  "bag": {
    "bouwjaar": 1993,
    "oppervlakte": 103
  },
  "wozStatus": "gevonden",
  "energielabel": {
    "status": "gevonden",
    "klasse": "C",
    "registratiedatum": "2021-06-14",
    "geldigTot": "2031-06-14"
  },
  "subsidietoets": {
    "status": "getoetst",
    "gemeente": {
      "code": "GM0363",
      "naam": "Amsterdam"
    },
    "nagelezen": "2026-10-12",
    "regelingen": [
      {
        "naam": "Extra Isolatie Subsidie Amsterdam (EISA)",
        "soort": "open",
        "uitkomst": "onder_grens",
        "grenzen": [
          {
            "euro": 666000,
            "peildatum": "2024-01-01",
            "wozWaarde": 612000
          }
        ],
        "voorwaarden": [
          {
            "tekst": "Gebouwd voor 1993",
            "waarde": "1968"
          }
        ],
        "bedrag": "tot € 2.500",
        "bedragen": [
          {
            "doelgroep": "laag inkomen",
            "maxEuro": 4000,
            "percentage": 100,
            "voorwaarde": "inkomen tot 140% van het sociaal minimum"
          }
        ],
        "gewijzigd": "2026-10-01",
        "status": "Open",
        "nagelezen": "2026-10-12",
        "aanvragen": {
          "moment": "vooraf",
          "tekst": "Vraag aan voordat het werk begint, met de offerte van het bedrijf erbij.",
          "nagelezen": "2026-10-16"
        },
        "maatregelen": {
          "betaalt": [
            "spouwmuur",
            "vloer"
          ],
          "viaGemeente": [
            "spouwmuur",
            "vloer"
          ],
          "tekst": "Spouwmuur en vloer. Het dak alleen als die niet kunnen; glas niet."
        },
        "isde": {
          "regel": "aftrek"
        }
      }
    ]
  },
  "tegoed": {
    "soort": "proef",
    "limiet": 5,
    "gebruikt": 1,
    "resterend": 4
  }
}

WOZ-gegevens op basis van een volledig adres, bv. "Kalverstraat 1, 1012NX Amsterdam".

Request

Query parameters

Response

Example response

Changes