Adressen

WOZ-gegevens op basis van BAG nummeraanduiding-id.

Gebruik dit endpoint als je de BAG-id's al hebt, bijvoorbeeld uit een eerdere adres-lookup of uit een eigen BAG-import. Het slaat het opzoeken van het adres over, dus je bent niet afhankelijk van de schrijfwijze van een adres. Een nummeraanduiding is de brievenbus, een adresseerbaar object het verblijfsobject erachter; kies /Api/AdresseerbaarObject als je een verblijfsobject-id hebt.

Dezelfde creditregels als /Api/Adres: 1 credit per uniek adres, 7 dagen herhalen zonder extra credit, en een fout of een antwoord zonder WOZ-waarden kost niets.

get/Api/Nummeraanduiding/{id}

Request

Base URL: https://woz-api.nl
URL: https://woz-api.nl/Api/Nummeraanduiding/{id}
Auth: API key in header X-Api-Key

Path parameters

idstring required

BAG nummeraanduiding-id (16 cijfers).

Query parameters

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

Gevonden. 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
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.